Mokei MCP server

Installation

npm install @mokei/context-server

Basic Usage

import { createTool, serveProcess } from '@mokei/context-server'

serveProcess({
  name: 'my-server',
  version: '1.0.0',
  tools: {
    greet: createTool(
      'Greet a user by name',
      {
        type: 'object',
        properties: {
          name: { type: 'string' }
        },
        required: ['name']
      } as const,
      async (req) => {
        return {
          content: [{ type: 'text', text: `Hello, ${req.arguments.name}!` }]
        }
      }
    )
  }
})

Type-Safe Client Integration

The @mokei/context-server package provides utilities to extract TypeScript types from your server configuration, enabling type-safe client usage.

Extracting Types

Use ExtractServerTypes to derive types from your server configuration:

import {
  createTool,
  type ExtractServerTypes,
  type ServerConfig,
  type ToolDefinitions
} from '@mokei/context-server'

const tools = {
  greet: createTool(
    'Greet a user by name',
    {
      type: 'object',
      properties: {
        name: { type: 'string', description: 'User name' }
      },
      required: ['name'],
      additionalProperties: false
    } as const,
    async (req) => {
      return {
        content: [{ type: 'text', text: `Hello, ${req.arguments.name}!` }]
      }
    }
  )
} satisfies ToolDefinitions

export const config = {
  name: 'my-server',
  version: '1.0.0',
  tools
} satisfies ServerConfig

// Export types for client usage
export type MyServerTypes = ExtractServerTypes<typeof config>

Using Extracted Types in Clients

Import the exported types to get full type safety in your client:

import type { MyServerTypes } from './my-server'
import { ContextClient } from '@mokei/context-client'

const client = new ContextClient<MyServerTypes>({ transport })
await client.initialize()

// TypeScript knows the exact shape of arguments!
const result = await client.callTool({
  name: 'greet',
  arguments: { name: 'Alice' }  // ✓ Type-checked
})

// This will error at compile time:
// arguments: { invalid: 'field' }  // ✗ Type error

Available Type Utilities

• ExtractServerTypes<T> - Extract complete context types (Tools + Prompts)
• ExtractToolTypes<T> - Extract only tool argument types
• ExtractPromptTypes<T> - Extract only prompt argument types

Documentation