oh-my-claudecode
使用说明(简要、易操作版)
-
项目简介
- oh-my-claudecode 是一个面向 MCP 的后端框架,提供对资源(Resources)、工具(Tools)和提示模板(Prompts)的统一托管、访问与渲染能力,并实现了若干 MCP 服务器实例以及工具服务器,便于 LLM 客户端通过标准的 JSON-RPC 调用获取上下文、执行外部功能、渲染与获取 Prompt 模板等。
- 设计目标是安全、可扩展、易集成,适配多种传输协议(包括 STDIO、Unix Socket/TCP、SSE、WebSocket 等)。
-
主要功能点
- MCP 协议实现与处理
- 以 JSON-RPC 2.0 为核心的请求/响应处理,支持执行、查询状态、心跳等基本方法。
- 资源、工具和提示模板的托管与管理
- 提供资源数据访问、工具注册/执行、以及 Prompts 的渲染与渲染结果输出。
- MCP 服务器与工具服务器集合
- 实现 Exa、Context7、Memory、Filesystem、Playwright 等默认 MCP 服务,以及内置的 OMC Tools 服务器和 Team MCP 服务器等。
- 跨进程/跨会话的任务与历史管理
- 提供后台任务、提示持久化、跨进程通信等能力,支持日志、监控与分析工具。
- 多传输通道与互联
- 通过 STDIO、Unix Socket、TCP 等方式暴露 MCP 服务;并含有桥接层实现 JSON-RPC 交互。
- MCP 协议实现与处理
-
安装步骤
- 安装依赖并构建源码(适用于基于 npm 的工作流)
- 编译生成分发文件后,使用下列方式启动 MCP 服务器(示例,具体路径以实际构建产物为准):
- 启动基于 MCP 的独立服务器(Stand-alone SCP): node dist/mcp/standalone-server.js
- 启动带 JSON-RPC 的工具服务器/代理: node dist/mcp/standalone-server.js 或相关 dist 路径下的实现
- 如需要跨进程通信与桥接,可使用 bridge/gyoshu_bridge.py 等中间件实现 JSON-RPC 2.0 的 NDJSON 传输。
- 具体服务器可复用仓库内的示例配置与实现(如 Exa、Context7、Memory、Team/MCP 服务器等)。
-
服务器配置(示例,供 MCP 客户端参考,不作为客户端代码) 说明:MCP 客户端需要提供启动命令与参数来连接到 MCP 服务器。下列为 JSON 格式的配置示例,展示如何为一个 MCP 服务器注册启动信息。请据实际环境替换参数值。
-
serverName: exa command: npx args: ["-y", "exa-mcp-server"] env: { "EXA_API_KEY": "<你的 API Key>" }
-
serverName: context7 command: npx args: ["-y", "@upstash/context7-mcp"] env: {}
-
serverName: memory command: npx args: ["-y", "@modelcontextprotocol/server-memory"] env: {}
-
serverName: filesystem command: npx args: ["-y", "@modelcontextprotocol/server-filesystem", "<允许的路径列表>"] env: {}
注:以上配置仅用于描述 MCP 服务器启动信息。实际 MCP 客户端在连接服务器时通常需要使用服务器名称、启动命令和参数来建立连接,不需要客户端代码中的实现细节。
-
-
基本使用方法
- 启动一个或多个 MCP 服务器实例(如 Exa、Context7、Memory 等),确保相应的依赖与 API 密钥(如 EXA_API_KEY、ANTHROPIC_API_KEY 等)配置正确。
- 使用 Claude Code 等 MCP 客户端通过 JSON-RPC 向服务器发出请求(读取资源、执行工具、获取 Prompt),服务器解析请求、执行对应处理并返回 JSON-RPC 响应。
- 根据需要接入不同传输通道(STDIO、Unix Socket、WebSocket 等),以实现与客户端的实时协作与上下文服务。