Mokei

Mokei

用于创建、交互和监控客户端与服务端的 TypeScript 工具包，基于 Model Context Protocol（MCP）。

功能

• MCP 服务端和客户端 - 完整的协议实现
• 协议版本 - 支持并使用 2025-11-25 和 2026-07-28，可按上下文选择或自动协商
• 多上下文主机 - 管理多个 MCP 服务，并为工具命名空间
• 会话管理 - 提供支持工具调用的高级聊天抽象
• Agent 循环 - 自动执行工具，并可配置审批
• 模型提供方 - 集成 OpenAI、Anthropic、Ollama 和本地 GGUF（llama.cpp）
• 监控 - 实时观察 MCP 流量
• CLI - 交互式聊天和服务检查工具

快速开始

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

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

const session = new NodeSession({
  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!' }]
})

文档

• 完整文档 - 完整指南和 API 参考
• 快速入门指南 - 几分钟内即可开始使用
• docs/ - 本地文档

软件包

软件包	描述
@mokei/context-server	MCP 服务实现
@mokei/context-client	MCP 客户端实现
@mokei/host	多上下文编排器
@mokei/session	可移植的聊天和 Agent 会话
@mokei/session-node	Node stdio 会话支持
@mokei/openai-provider	OpenAI 集成
@mokei/anthropic-provider	Anthropic Claude 集成
@mokei/ollama-provider	Ollama 集成
@mokei/llama-provider	通过 node-llama-cpp 进行本地 GGUF 推理
@mokei/http-client	MCP Streamable HTTP 客户端传输
@mokei/http-server	MCP Streamable HTTP 服务端传输
@mokei/flow-host	Mokei 工作流主机：在后台运行决策流，并提供审批、收件箱和恢复功能
@mokei/flow-host-node	Mokei Node 工作流主机：为决策流提供持久化存储和可观测性
@mokei/flow-client	Mokei 工作流客户端：为工作流守护进程提供可移植的工作流控制接口、类型和错误
@mokei/host-desktop	为 Mokei 主机提供桌面弹窗、通知和输入收件箱
@mokei/decision-flow	用于工作流图的 Mokei 决策流节点类型
mokei	CLI 工具

CLI

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 <command>    # Proxy an MCP server through the daemon
mokei daemon status      # Manage the per-user daemon
mokei flows list         # Inspect configured flows
mokei runs list          # Inspect flow runs
mokei inbox list         # Inspect pending inputs and approvals

参与贡献

开发环境设置和代码风格指南请参阅 AGENTS.md。

许可证

MIT