mokei

TypeScript toolkit for creating, interacting and monitoring clients and servers using the Model Context Protocol

0 stars TypeScriptDeveloper Kits Updated Jul 19, 2025

aidevtoolsmcpmcp-clientmcp-servertypescript

Documentation

Mokei

TypeScript toolkit for creating, interacting with, and monitoring clients and servers using the Model Context Protocol (MCP).

Features

MCP Server & Client - Full protocol implementation
Protocol Revisions - Serves and speaks both `2025-11-25` and `2026-07-28`, selected per context or negotiated automatically
Multi-Context Host - Manage multiple MCP servers with tool namespacing
Session Management - High-level chat abstraction with tool calling
Agent Loop - Automatic tool execution with configurable approval
Model Providers - OpenAI, Anthropic, Ollama, and local GGUF (llama.cpp) integration
Monitoring - Real-time observation of MCP traffic
CLI - Interactive chat and server inspection tools

Quick Start

bash

pnpm add @mokei/session @mokei/openai-provider

typescript

import { Session } from '@mokei/session'
import { OpenAIProvider } from '@mokei/openai-provider'

const session = new Session({
  providers: {
    openai: OpenAIProvider.fromConfig({
      apiKey: process.env.OPENAI_API_KEY
    })
  }
})

// Add an MCP server
await session.addContext({
  key: 'myserver',
  command: 'node',
  args: ['my-mcp-server.js']
})

// Chat with tool access
const response = await session.chat({
  provider: 'openai',
  model: 'gpt-4',
  messages: [{ source: 'client', role: 'user', text: 'Hello!' }]
})

Documentation

**Full Documentation** - Complete guides and API reference
**Quick Start Guide** - Get running in minutes
**docs/** - Local documentation

Packages

Package	Description
`@mokei/context-server`	MCP server implementation
`@mokei/context-client`	MCP client implementation
`@mokei/host`	Multi-context orchestrator
`@mokei/session`	High-level session management
`@mokei/openai-provider`	OpenAI integration
`@mokei/anthropic-provider`	Anthropic Claude integration
`@mokei/ollama-provider`	Ollama integration
`@mokei/llama-provider`	Local GGUF inference via node-llama-cpp
`@mokei/http-client`	MCP Streamable HTTP client transport
`@mokei/http-server`	MCP Streamable HTTP server transport
`mokei`	CLI tool

CLI

bash

mokei monitor            # Start the monitor UI for MCP server traffic
mokei inspect            # Inspect an MCP server (prints how it describes itself)
mokei chat -p openai     # Interactive chat
mokei proxy     # Proxy an MCP server through the daemon

Contributing

See AGENTS.md for development setup and code style guidelines.

License

MIT

Frequently asked questions

What is mokei?

mokei is TypeScript toolkit for creating, interacting and monitoring clients and servers using the Model Context Protocol

How do I install mokei?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mokei open source?

Yes — it is hosted on GitHub at https://github.com/TairuFramework/mokei.

Related MCP tools

composio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf

25,863 TypeScript

agentic-aiagentsai+14

repomix

📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...

19,761 TypeScript

aianthropicartificial-intelligence+17

mastra

The TypeScript AI agent framework. ⚡ Assistants, RAG, observability. Supports any LLM: GPT-4, Claude, Gemini, Llama. Built for the Model Context Protocol to enh

18,004 TypeScript

agentsaichatbots+10