项目简介

MCP项目上下文管理器是一个基于Model Context Protocol (MCP) 标准开发的服务器，旨在为大型语言模型（LLM）客户端（如Claude Desktop）提供深入的项目理解和交互能力。它能够自动识别项目结构、管理上下文信息、提供文件和Git操作工具，并维护项目特定的记忆，从而极大地提升LLM在代码开发、审查和调试等任务中的效率和准确性。

主要功能点

项目智能发现: 自动识别Git仓库、项目语言、框架、包管理器和构建工具，快速了解项目全貌。
分层记忆系统: 采用知识图谱技术进行持久化存储，实现项目记忆隔离，支持用户偏好管理和跨会话上下文保留。
实时上下文管理: 自动加载项目上下文，实时监控文件变动和Git状态，并智能过滤相关信息。支持类似Claude Code的'@import'语法。
丰富的工具集: 提供文件读写、目录操作、Git操作（如查看状态、差异、提交）、上下文检索、记忆搜索与管理等功能，允许LLM直接与项目互动。
可访问资源: 通过MCP客户端直接访问项目概览、目录结构、'CLAUDE.md'说明文档和重要项目文件。
定制化Prompt模板: 提供预设的Prompt模板，如项目开发上下文、代码审查、调试上下文、功能开发和重构指导，帮助LLM更好地理解并完成特定任务。

安装步骤

克隆仓库: 首先，在您选择的目录（例如 'C:' 或 '~/'）中克隆项目仓库。打开终端或命令行工具，执行以下命令：

git clone https://github.com/crycool/mcp-project-context mcp-project-context
cd mcp-project-context

安装依赖: 进入项目目录后，安装所有必要的依赖：
```
npm install
```
构建项目: 构建项目以生成可执行文件：
```
npm run build
```

服务器配置

此MCP服务器需要通过MCP客户端（如Claude Desktop）进行配置才能启动和使用。请将以下JSON配置添加到您的Claude Desktop配置文件中。

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Linux: '~/.config/claude/claude_desktop_config.json'

{
  "mcpServers": {
    "project-context": { // 服务器的唯一名称，用于在Claude Desktop中识别
      "command": "node", // 启动服务器的命令
      "args": ["C:\\mcp-project-context\\dist\\index.js"], // 传递给命令的参数，这里指向服务器的入口文件。请将路径替换为您的实际安装路径。
      "cwd": "C:\\your-project-directory" // 服务器的工作目录，应设置为您希望LLM访问的项目根目录。请替换为您的实际项目路径。
    }
  }
}

注意: 请确保 'args' 和 'cwd' 中的路径与您实际的项目安装位置和您希望管理的项目的根目录相符。

基本使用方法

启动Claude Desktop: 当您启动Claude Desktop时，根据上述配置，MCP项目上下文服务器将自动启动。
导航至您的项目: 确保在配置文件中设置了正确的 'cwd'，指向您希望LLM交互的项目目录。
自动发现与上下文加载: 服务器会自动检测项目类型、结构，加载'CLAUDE.md'指令，初始化记忆系统，并开始监控文件变化。
与Claude交互: 您现在可以在Claude Desktop中使用与项目相关的工具、资源和Prompt模板。例如，您可以让Claude：
- 使用 'read_file' 工具读取某个文件的内容。
- 请求 'Project overview' 资源以获取项目概览。
- 使用 'code_review' Prompt模板来审查特定代码文件。
- 通过 'search_memories' 查找项目历史记录中的相关信息。

关键词

信息