MCP Servers

MCP 服务

此代码库包含各种 Model Context Protocol（MCP）服务，用于增强 Cursor 的功能。

前置条件

安装前，请确保满足以下条件：

1. 操作系统

   • macOS（安装了 Homebrew），或
   • Linux（安装了 apt-get）

2. 系统要求

   • Python 3.10 或更高版本
   • Node.js 18 或更高版本（默认安装版本：Node.js 22.13.1）
   • 对安装目录具有写入权限

安装

此代码库包含一个功能全面的 Makefile，用于自动安装：

1. 第一阶段（系统设置）：

make phase1

2. 重启终端

3. 第二阶段（MCP 安装）：

make phase2

其他 Make 命令

• make update-all：更新所有 MCP 服务
• make clean：移除已安装的依赖项
• make clean-deep：彻底清理系统

可用的 MCP 服务

1. Git MCP

与本地 Git 代码库交互并自动执行操作：

• 代码库状态和文件操作
• 分支和提交管理
• 差异操作（已暂存、未暂存、分支间比较）

2. Brave Search MCP

网页和本地搜索功能：

• 可进行筛选的网页搜索
• 本地商家搜索
• 新闻和文章搜索

3. GitHub MCP

GitHub 集成与自动化：

• 代码库管理
• 问题和 PR 处理
• 分支操作

4. Memory MCP

持久化存储和检索：

• 知识图谱管理
• 实体和关系跟踪
• 搜索功能

5. Sequential Thinking MCP

结构化问题解决：

• 逐步分析
• 动态修订思路
• 上下文维护

配置

必需的 API 密钥

1. Brave Search API 密钥

   export BRAVE_API_KEY=your_key_here
   

   在此获取密钥：https://brave.com/search/api/

2. GitHub 个人访问令牌

   export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here
   

   在此生成：https://github.com/settings/tokens 所需权限范围：repo、workflow（可选）

Cursor 设置

在 Cursor 中配置各个 MCP（Settings > Features > MCP）：

1. Git MCP

   {
     "name": "Git",
     "type": "stdio",
     "command": "uvx mcp-server-git --repository /path/to/your/repo"
   }
   

2. Brave Search MCP

   {
     "name": "Brave Search",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-brave-search"
   }
   

3. GitHub MCP

   {
     "name": "GitHub",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-github"
   }
   

4. Memory MCP

   {
     "name": "Memory",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-memory"
   }
   

5. Sequential Thinking MCP

   {
     "name": "Sequential Thinking",
     "type": "stdio",
     "command": "npx -y @modelcontextprotocol/server-sequential-thinking"
   }
   

故障排除

1. 安装问题

   • 运行 make verify-installation 检查所有组件
   • 查看系统日志中的错误消息
   • 确保满足所有前置条件

2. API 密钥问题

   • 确认环境变量设置正确
   • 检查 API 密钥的权限和范围
   • 确认密钥未过期

3. Cursor 配置

   • 确认 Cursor 中的 MCP 设置
   • 检查命令路径和参数
   • 修改配置后重启 Cursor