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 服务器核心实现:
-
安装步骤
- 克隆或获取源码后,进入 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-server 目录,安装依赖并构建:
-
服务器配置(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 请求访问各类资源、执行工具、读取段落等能力,例如:
-
特色与兼容性
- 兼容 MCP 服务器核心功能:资源、工具、Prompts 的注册与执行,以及对请求/响应的标准化处理
- 基于 stdio 的传输实现,便于在 CLI 流程中直接与 Claude Code 会话协同工作
- 具备完整的示例、安全相关的威胁数据库、以及可扩展的内容加载机制
-
注意
- 由于实际部署可能依赖于构建产物和运行环境,请确保依赖正确安装且能以可执行 MCP 服务器形式运行。
- 客户端配置请以本仓库提供的示例为准进行定制,以确保服务器名称、版本、传输类型及入口正确对齐。
-
参考说明
- 项目中提供了完整的 MCP 服务端实现、工具、资源、提示、以及内容加载/缓存等模块,具体实现可查看 mcp-server 目录下的 server.ts、index.ts、prompts、resources、tools 等文件。