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 交互。
  • 安装步骤

    • 安装依赖并构建源码(适用于基于 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 等),以实现与客户端的实时协作与上下文服务。

服务器信息