Claude Code Ultimate Guide MCP 服务器

使用说明内容(Markdown格式)

Claude Code Ultimate Guide MCP 服务器

  • 项目简介

    • 该仓库实现了一个完整的 MCP 服务器,用于为 Claude Code 的客户端提供统一的上下文服务。服务器托管资源、暴露工具、提供提示模板的注册与执行能力,并实现了多种资源渲染和上下文能力,以支持 LLM 客户端在会话中读取文档、执行操作、获取答案等。
  • 主要功能点

    • MCP 服务器核心实现:
      • 通过 MCP 协议接收请求、返回 JSON-RPC 风格响应,处理资源、工具、Prompts 的注册与执行。
      • 会话管理、能力声明、以及对资源/工具/提示的统一访问接口。
    • 资源托管与概要渲染:
      • 暴露 reference.yaml、cla Claude Code Releases、llms.txt 等资源,支持直接读取与联动渲染。
    • 工具注册与执行:
      • 提供多种工具(如 read_section、search_guide、get_example、list_topics、get_threat、get_release 等),支持查询、分段读取、示例获取、版本对比等能力。
    • Prompts 与对话能力:
      • 注册诸如 claude-code-expert 等提示,支持 LLM 在会话中直接调用并获得上下文与模板化响应。
    • 内容加载与缓存:
      • 支持本地开发模式(DEV 模式)通过 GUIDE_ROOT 加载内容,生产模式通过缓存与 GitHub 原始内容获取内容。
    • 安全、可扩展性设计:
      • 包含安全工具、威胁数据库、分层引用解析、以及多种资源格式渲染,便于扩展新的工具、资源与促发逻辑。
  • 安装步骤

    • 克隆或获取源码后,进入 mcp-server 目录,安装依赖并构建:
      • 安装依赖
      • 构建产出为可执行的 MCP 服务器程序
    • 启动服务器(使用本仓库的 MCP 服务器实现,通常以 CLi/Node 导出形式运行)
      • 推荐运行方式(示例,用于客户端配置的可执行入口):
        • 通过 MCP 客户端以 stdio 传输连接服务器
        • 服务器名称为 claude-code-ultimate-guide,版本 1.0.0
    • 运行示例(与客户端配置对应的命令格式由 MCP 客户端决定,示例用 npx 启动方式):
      • npx claude-code-ultimate-guide-mcp
    • 服务器可在启动后通过客户端进行资源查询、工具调用、Prompts 触发等 MCP 操作
  • 服务器配置(MCP 客户端需要的连接信息) 说明:以下为 MCP 客户端需要的配置信息,JSON 格式用于描述如何连接该服务器。该配置并非运行时代码,仅用于连接描述与示例注释。实际使用时请在客户端配置中以 JSON 形式提供。

{ "server_name": "claude-code-ultimate-guide", "version": "1.0.0", "transport": "stdio", "command": "npx", "args": ["-y", "claude-code-ultimate-guide-mcp"], "description": "Claude Code Ultimate Guide MCP 服务器(STDIO 传输)", "notes": "该配置用于 MCP 客户端连接该服务器。" }

  • 基本使用方法

    • 启动后,客户端可以通过 MCP 请求访问各类资源、执行工具、读取段落等能力,例如:
      • 读取参考索引、获取版本历史、查询威胁数据库、读取特定段落、查找示例模板等
    • 客户端通过调用服务器暴露的工具、资源、Prompts 来实现对 Claude Code 的上下文查询与协助任务
    • 服务器内部实现了会话管理、能力声明及在多种资源类型之间的联动支持,便于拓展新的工具、资源与 Prompt
  • 特色与兼容性

    • 兼容 MCP 服务器核心功能:资源、工具、Prompts 的注册与执行,以及对请求/响应的标准化处理
    • 基于 stdio 的传输实现,便于在 CLI 流程中直接与 Claude Code 会话协同工作
    • 具备完整的示例、安全相关的威胁数据库、以及可扩展的内容加载机制
  • 注意

    • 由于实际部署可能依赖于构建产物和运行环境,请确保依赖正确安装且能以可执行 MCP 服务器形式运行。
    • 客户端配置请以本仓库提供的示例为准进行定制,以确保服务器名称、版本、传输类型及入口正确对齐。
  • 参考说明

    • 项目中提供了完整的 MCP 服务端实现、工具、资源、提示、以及内容加载/缓存等模块,具体实现可查看 mcp-server 目录下的 server.ts、index.ts、prompts、resources、tools 等文件。

服务器信息