MCP 服务器

此仓库包含多种模型上下文协议（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 搜索 MCP

网络和本地搜索功能：

• 带有筛选的网络搜索
• 本地企业搜索
• 新闻和文章搜索

3. GitHub MCP

GitHub 集成和自动化：

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

4. 内存 MCP

持久存储和检索：

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

5. 顺序思考 MCP

结构化的问题解决：

• 步骤式分析
• 动态思维修订
• 上下文维护

配置

必需的 API 密钥

1. Brave 搜索 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（设置 > 功能 > MCP）：

1. Git MCP

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

2. Brave 搜索 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. 内存 MCP

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

5. 顺序思考 MCP

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

注意事项

• 安装过程中请确保网络连接正常。
• 如果遇到问题，请检查终端输出的错误信息，并根据提示进行调整。