Cursor MCP Guide

🚀 瞭解 MCP（模型上下文協議）與 GitHub 集成

模型上下文協議 (MCP) 是一種革命性的標準化協議，它讓 AI 代理能夠與各類工具和服務實現無縫通信。簡單來說，它就如同一個通用翻譯器，解決了 AI 代理與多工具集成的難題。

🚀 快速開始

在深入瞭解 MCP 與 GitHub 集成之前，我們先來整體認識一下 MCP 的作用和優勢。

✨ 主要特性

什麼是 MCP？

模型上下文協議 (MCP) 是一種革命性的標準化協議，使 AI 代理能夠與各種工具和服務無縫通信。想象一下，它就像一個通用翻譯器：

• 無 MCP：每個工具都有自己的語言，使得 AI 代理難以集成到多個工具中。
• 有 MCP：所有工具都使用同一種語言，實現輕鬆集成和通信。

實際案例

假設你有十位專家顧問，每位都說不同的語言：

• 無 MCP：你需要十種不同的翻譯器。
• 有 MCP：所有人說共同的語言，使合作變得輕而易舉。

這種標準化使 AI 代理能夠：

• 連接數據庫
• 與 GitHub 交互
• 訪問雲服務
• 管理文件和文檔
• 以及更多！

GitHub MCP 功能

GitHub MCP 集成提供了強大的與 GitHub 倉庫交互的功能：

倉庫管理

• 創建新倉庫
• 叉取現有倉庫
• 克隆倉庫
• 管理分支
• 創建和合並拉取請求

代碼操作

• 搜索代碼
• 創建和編輯文件
• 提交更改
• 審查拉取請求
• 添加評論和審查

問題管理

• 創建和更新問題
• 添加問題評論
• 搜索問題
• 應用標籤和指定人
• 跟蹤里程碑

協作功能

• 管理項目面板
• 處理討論
• 審查評論
• 管理倉庫設置
• 控制訪問權限

📦 安裝指南

先決條件：Node.js 設置

1. 訪問 Node.js 網站
2. 下載相應版本：
   • 對於 M1/M2 Mac：macOS ARM64
   • 對於 Intel Mac：macOS x64
3. 運行安裝程序並按照提示操作

安裝 GitHub MCP

方法 1：使用 Smithery CLI（推薦）

npx -y @smithery/cli@latest install @smithery-ai/github \
  --client cursor \
  --config '{"githubPersonalAccessToken":"your_token_here"}'

方法 2：手動配置

1. 打開 ~/.cursor/mcp.json
2. 添加以下配置：

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}

💻 使用示例

基礎用法

安裝完成後，你可以使用 GitHub MCP 來：

1. 創建和管理倉庫
2. 處理問題和拉取請求
3. 搜索代碼
4. 管理文件和分支
5. 與團隊成員協作

在 Smithery 上查找 MCP 服務器

1. 訪問 Smithery
2. 瀏覽可用的 MCP 服務器：
   • 按類別過濾
   • 按流行度排序
   • 搜索名稱或功能
3. 選擇“GitHub MCP”
4. 遵循安裝說明

添加到 Cursor

方法 1：命令行安裝

# 使用 Smithery CLI
npx @smithery/cli install @smithery-ai/github

方法 2：手動配置

1. 打開 Cursor 設置：
   • 使用 ⌘ + Shift + P（macOS）或 Ctrl + Shift + P（Windows）
   • 輸入“Cursor 設置”
   • 選擇“MCP”
2. 添加 MCP 服務器：
   • 點擊“添加新的全局 MCP 服務器”
   • 使用提供的 JSON 結構進行配置

方法 3：直接 JSON 配置

1. 轉到 ~/.cursor/mcp.json
2. 手動添加服務器配置：

{
  "mcp_servers": {
    "github": {
      "command": "npx @smithery/github-mcp --token your_github_token"
    }
  }
}