Claude Code Explorer MCP

warrioraashuu Codemaster — MCP 服务

一个独立的 Model Context Protocol（MCP）服务，可让任何兼容 MCP 的客户端探索 Claude Code 源代码。由 warrioraashuu 重新命名并发布。支持 STDIO、Streamable HTTP 和 SSE 传输方式。

功能

提供 8 个工具、3 个资源和 5 个提示词，用于浏览包含约 1,900 个文件、超过 512K 行代码的 Claude Code 代码库。这是官方 npm 包：warrioraashuu-codemaster。

传输方式

传输方式	端点	适用场景
STDIO	node dist/index.js	Claude Desktop、本地 Claude Code、VS Code
Streamable HTTP	POST/GET /mcp	新式 MCP 客户端、远程托管
Legacy SSE	GET /sse + POST /messages	较旧的 MCP 客户端

工具

工具	描述
list_tools	列出全部 40 多个 Agent 工具（BashTool、FileEditTool 等）
list_commands	列出全部 50 多个斜杠命令（/commit、/review 等）
get_tool_source	读取特定工具的实现
get_command_source	读取特定命令的实现
read_source_file	按相对路径读取 src/ 中的任意文件
search_source	使用正则表达式搜索整个源代码树
list_directory	列出 src/ 下任意目录的内容
get_architecture	获取完整的架构概览

资源

URI	描述
claude-code://architecture	README／架构概览
claude-code://tools	工具注册表（JSON）
claude-code://commands	命令注册表（JSON）
claude-code://source/{path}	任意源文件（模板）

提示词

提示词	描述
explain_tool	深入讲解特定工具的用途、架构、权限和流程
explain_command	讲解特定斜杠命令的行为和实现
architecture_overview	引导式探索 Claude Code 的完整架构
how_does_it_work	讲解某项功能／子系统（权限、MCP、桥接等）
compare_tools	并排比较两个工具

设置

cd mcp-server
npm install
npm run build

本地运行（STDIO）

npm start
# or with custom source path:
CLAUDE_CODE_SRC_ROOT=/path/to/src npm start

本地运行（HTTP）

npm run start:http
# Streamable HTTP at http://localhost:3000/mcp
# Legacy SSE at http://localhost:3000/sse
# Health check at http://localhost:3000/health

使用身份验证

MCP_API_KEY=your-secret-token npm run start:http
# Clients must include: Authorization: Bearer your-secret-token

配置

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "warrioraashuu-codemaster": {
      "command": "node",
      "args": ["/absolute/path/to/claude-code/mcp-server/dist/index.js"],
      "env": {
        "CLAUDE_CODE_SRC_ROOT": "/absolute/path/to/claude-code/src"
      }
    }
  }
}

VS Code（GitHub Copilot）

添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "claude-code-explorer": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/mcp-server/dist/index.js"],
      "env": {
        "CLAUDE_CODE_SRC_ROOT": "${workspaceFolder}/src"
      }
    }
  }
}

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "claude-code-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/claude-code/mcp-server/dist/index.js"],
      "env": {
        "CLAUDE_CODE_SRC_ROOT": "/absolute/path/to/claude-code/src"
      }
    }
  }
}

环境变量

变量	默认值	描述
CLAUDE_CODE_SRC_ROOT	../src（相对于 dist/）	Claude Code src/ 目录的路径
PORT	3000	HTTP 服务端口（仅限 HTTP 模式）
MCP_API_KEY	(无)	HTTP 身份验证的 Bearer 令牌（可选）

远程 HTTP 客户端配置

配置 Claude Desktop 以连接远程服务：

{
  "mcpServers": {
    "claude-code-explorer": {
      "url": "https://your-deployment.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-key"
      }
    }
  }
}

部署

Railway

1. 将 GitHub 仓库连接到 Railway
2. Railway 会自动检测 mcp-server/Dockerfile
3. 在 Railway 控制面板中设置环境变量：
   • MCP_API_KEY — 机密 Bearer 令牌
   • PORT 由 Railway 自动设置
4. 部署 — 可通过 your-app.railway.app 访问

也可通过 CLI 部署：

railway init
railway up

Vercel

npx vercel

在 Vercel 控制面板中设置环境变量：

• CLAUDE_CODE_SRC_ROOT — 打包 src/ 文件的路径
• MCP_API_KEY — Bearer 令牌

注意：Vercel 函数是无状态的，且有执行时间限制（爱好者版 10 秒／专业版 60 秒）。适用于简单的工具调用。若需持久 SSE 流，请使用 Railway 或 Docker。

Docker

# From repo root
docker build -f mcp-server/Dockerfile -t claude-code-mcp .
docker run -p 3000:3000 -e MCP_API_KEY=your-secret claude-code-mcp

适用于任何 Docker 主机：Fly.io、Render、AWS ECS、Google Cloud Run 等。

提示词

该服务还提供了用于引导探索的提示词模板：

提示词	描述
explain_tool	深入解释特定工具（输入架构、权限、执行流程）
explain_command	解释斜杠命令的工作方式
architecture_overview	引导了解整个 Claude Code 架构
how_does_it_work	解释某项功能或子系统（例如“权限系统”“MCP 客户端”“查询引擎”）
compare_tools	并排比较两个工具

示例用法

连接后，你可以向 AI 助手提出如下问题：

• “列出所有 Claude Code 工具”
• “给我看看 BashTool 的实现”
• “搜索权限检查的相关代码”
• “bridge 目录中有哪些文件？”
• “读取 QueryEngine.ts 文件的第 1–100 行”
• “MCP 客户端连接是如何工作的？”
• 使用 explain_tool 提示词，并输入“FileEditTool”，获取完整解析
• 使用 how_does_it_work 提示词，并输入“bridge”，了解 IDE 集成

发布到 MCP Registry

此服务通过 GitHub Actions 发布到 MCP Registry。创建带标签的版本（v*）时，工作流会：

1. 将 npm 包发布到 npmjs.org
2. 使用 GitHub OIDC 向 MCP Registry 进行身份验证
3. 将 server.json 元数据发布到注册表

手动发布：

# Install the MCP Publisher CLI
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

# Authenticate (GitHub OAuth)
./mcp-publisher login github

# Publish
cd mcp-server
../mcp-publisher publish

注册表名称：warrioraashuu-codemaster

开发

npm install
npm run dev    # Watch mode TypeScript compilation
npm run build  # Compile TypeScript to dist/
npm start      # Run STDIO server
npm run start:http  # Run HTTP server

架构

mcp-server/
├── src/
│   ├── server.ts    — Shared MCP server (tools, resources, prompts) — transport-agnostic
│   ├── index.ts     — STDIO entrypoint (local)
│   └── http.ts      — HTTP + SSE entrypoint (remote)
├── api/
│   ├── index.ts     — Vercel serverless function
│   └── vercelApp.ts — Express app for Vercel
├── Dockerfile       — Docker build (Railway, Fly.io, etc.)
├── railway.json     — Railway deployment config
├── package.json
└── tsconfig.json