Claude Context MCP Server

一个 MCP (Model Context Protocol) 服务器，用于访问 Claude Code 项目的上下文信息（index 和 resolutions）。

功能特性

此 MCP 服务器提供两个工具：

1. read_context_index - 读取项目的 .claude/context/index.json，获取上一轮对话的摘要信息
2. read_context_resolution - 读取特定问题解决方案的详细信息

安装

$3

``bash
npm install -g claude-context-mcp
`

$3

`bash
npm install claude-context-mcp
`

配置

$3

将此 MCP 服务器添加为用户级配置，在所有项目中都可以使用：

`bash
claude mcp add --transport stdio --scope user claude-context \
-- npx -y claude-context-mcp
`

$3

在特定项目中配置：

`bash
claude mcp add --transport stdio --scope local claude-context \
-- npx -y claude-context-mcp
`

$3

编辑 ~/.claude.json 文件（用户级）或项目的 .mcp.json 文件（项目级）：

`json
{
"mcpServers": {
"claude-context": {
"type": "stdio",
"command": "npx",
"args": ["-y", "claude-context-mcp"],
"env": {}
}
}
}
`

如果您已全局安装，也可以直接使用：

`json
{
"mcpServers": {
"claude-context": {
"type": "stdio",
"command": "claude-context-mcp",
"args": [],
"env": {}
}
}
}
`

使用方法

配置完成后，在 Claude Code 中可以使用以下工具：

$3

`
查看之前的实现和决策

> 使用 read_context_index 工具查看当前项目的上下文
`

MCP 工具会自动读取当前项目的 .claude/context/index.json 文件。

$3

当您从 index 中发现相关的解决方案（例如 res-001），可以获取详细信息：

`
> 使用 read_context_resolution 工具读取 resolution_id 为 "res-001" 的详细信息
`

$3

`
开发者: 我要实现用户认证功能

Claude: 让我先查看之前有没有相关的实现...
> [调用 read_context_index 工具]

Claude: 我在上下文中找到了一个相关的解决方案 res-003，关于认证流程的实现。
让我查看详细信息...
> [调用 read_context_resolution 工具，resolution_id: "res-003"]

Claude: 根据之前的实现经验，我建议采用以下方案...
`

项目结构要求

此 MCP 服务器期望项目中存在以下结构：

`
your-project/
├── .claude/
│ └── context/
│ ├── index.json # 上下文索引文件
│ └── resolutions/ # 解决方案详情目录
│ ├── res-001.json
│ ├── res-002.json
│ └── ...
`

工作原理

- MCP 服务器通过 stdio 传输与 Claude Code 通信
- 服务器会自动使用调用时的当前工作目录作为项目路径
- 哪个项目调用它，它就读取哪个项目下的 .claude/context/ 文件
- 支持自定义 project_path 参数来指定项目路径（可选）

验证安装

`bash


查看已配置的 MCP 服务器

claude mcp list

查看具体配置

claude mcp get claude-context
`

故障排查

$3

1. 检查 npx 是否可用：
`bash
npx --version
`

2. 检查 MCP 服务器配置：
`bash
claude mcp get claude-context
`

$3

确保项目中存在 .claude/context/index.json 文件。此文件通常由之前的 Claude Code 会话自动创建。

$3

在原生 Windows（非 WSL）上，使用 npx 需要 cmd /c 包装器：

`bash
claude mcp add --transport stdio --scope user claude-context \
-- cmd /c npx -y claude-context-mcp
`

开发

$3

`bash


克隆仓库

git clone
cd claude-context-mcp

安装依赖

npm install

构建

npm run build

监听模式

npm run watch
`

$3

在本地开发时，可以使用本地路径配置：

`bash
claude mcp add --transport stdio --scope local claude-context-dev \
-- node /path/to/claude-context-mcp/build/index.js
``

许可证

MIT

贡献

欢迎提交 Issue 和 Pull Request！