用途
project-context-mcp 旨在解决使用 Claude Code 时缺乏项目背景知识的问题。它让开发者可以将团队的编码规范、架构决策、数据库模式陷阱、API 设计模式等“隐性知识”放入项目的 .context/ 文件夹，Claude Code 便能通过 @ 提及（@ mentions）直接访问这些文档，使 Claude 更了解你的代码库和项目约定。
主要能力
- 在 Claude Code 中通过 @ 提及引用 .context/ 文件夹内的文档。
- 自动发现并递归包含子文件夹中的支持文件。
- 智能资源名称：Markdown 文件使用第一个 # 标题作为名称；其他文件将文件名转为标题大小写（如 api-patterns.md → "Api Patterns"）。
- 自动描述：每个文件的首段成为自动补全中显示的描述，帮助你快速选择。
- 资源使用 context:// 协议，例如 .context/architecture.md → context://architecture.md，.context/api/patterns.md → context://api/patterns.md。
- 零配置：无需配置文件、环境变量或额外设置，只需创建 .context/ 文件夹即可。
- 自动排除隐藏文件（如 .foo）、pycache、node_modules、.git、.DS_Store。
使用方式
- 安装 MCP 服务器（一次性）：
- 推荐使用 uvx（无需安装）：具体命令资料未提供。
- 替代方案：pip install，具体命令资料未提供。
- 开发模式：从源码安装，具体步骤资料未提供。 安装后服务器将在所有 Claude Code 会话中可用。
- 在项目中创建 .context/ 文件夹。
- 在 Claude Code 中输入 @，即可看到上下文文件与源文件一起出现，选择即可将文件内容纳入提示词。
工作流程
- 启动时：MCP 服务器检查当前目录是否存在 .context/。
- 键入 @ 时：Claude Code 请求可用资源。
- 服务器响应：返回包含文件名、描述和 URI 的文件列表。
- 选择时：获取文件内容并包含到提示词中。
适用场景
- 新成员入职：将 .context/ 文件夹纳入仓库，新开发者从第一天起就能获得与资深成员相同的 Claude 体验。
- 强制执行一致性：将编码标准放入 .context/conventions.md，Claude 会建议符合模式的代码。
- 复杂领域知识：如医疗、金融、法律科技，将领域词汇和业务规则放入 .context/，避免 Claude 混淆术语。
- 遗留代码库：记录遗留决策的“原因”，重构时可引用 @legacy-decisions.md 说明约束。
- 多服务架构：将架构文档放入上下文，帮助 Claude 在修改时尊重服务边界和通信模式。
支持的文件类型
服务器暴露具有特定扩展名的文件（具体扩展名列表资料未提供完整内容）。
限制与注意事项
- 文件夹名必须精确为 .context/（带点）。
- 仅包含支持的文件类型。
- 修改 .context/ 后可能需要重启 Claude Code，因为 MCP 服务器在启动时初始化。
- 可运行
claude mcp list检查服务器是否注册；直接运行服务器可查看日志。 - 当前功能包括：文件监控热重载、context.yaml 清单自定义元数据、跨上下文文件搜索、远程上下文支持（URL、Notion、Confluence）、云存储团队同步等尚在构想中，资料未说明已实现。
- 许可：MIT License。
- 该项目实现了 Model Context Protocol，为 Claude Code 提供服务。
