Github MCP Server Ts

🚀 GitHub MCP 使用說明

本項目提供了使用GitHub API進行問題、拉取請求、里程碑、標籤和評論管理的方法，同時包含搜索查詢語法、設置指南、構建說明等內容。

🚀 快速開始

你可以按照以下步驟快速使用GitHub MCP：

1. 創建個人訪問令牌，具體步驟見“設置指南”中的“個人訪問令牌創建”。
2. 根據需求使用不同的API進行操作，如創建問題、拉取請求等。

💻 使用示例

基礎用法

問題創建示例

curl -X POST https://api.github.com/repos/{owner}/{repo}/issues \
-H "Authorization: token <YOUR_TOKEN>" \
-d '{"title":"這是一個測試問題","body":"這個問題是用於測試GitHub API的。"}'

拉取請求創建示例

curl -X POST https://api.github.com/repos/{owner}/{repo}/pulls \
-H "Authorization: token <YOUR_TOKEN>" \
-d '{"title":"這是一個測試拉取請求","body":"這個拉取請求是用於測試GitHub API的。","head":"main","base":"main"}'

高級用法

里程碑管理 - 創建新里程碑

curl -X POST https://api.github.com/repos/{owner}/{repo}/milestones \
-H "Authorization: token <YOUR_TOKEN>" \
-d '{"title":"v1.0","state":"open","description":"版本1.0的發佈"}'

標籤管理 - 創建新標籤

curl -X POST https://api.github.com/repos/{owner}/{repo}/labels \
-H "Authorization: token <YOUR_TOKEN>" \
-d '{"name":"bug","color":"ff0000"}'

評論管理 - 添加問題評論

curl -X POST https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}/comments \
-H "Authorization: token <YOUR_TOKEN>" \
-d '{"body":"這是一個測試評論。"}'

📚 詳細文檔

搜索查詢語法

代碼搜索

• language:javascript：按編程語言搜索
• repo:owner/name：在特定倉庫中搜索
• path:app/src：按路徑搜索
• extension:js：按文件擴展名搜索
• 示例：q: "import express" language:typescript path:src/

問題搜索

• is:issue 或 is:pr：按類型篩選
• is:open 或 is:closed：按狀態篩選
• label:bug：按標籤篩選
• author:username：按作者篩選
• 示例：q: "memory leak" is:issue is:open label:bug

用戶搜索

• type:user 或 type:org：按賬戶類型篩選
• followers:>1000：按關注者數量篩選
• location:London：按位置篩選
• 示例：q: "John Doe" type:user location:New York

設置指南

個人訪問令牌創建

1. 登錄你的GitHub賬戶。
2. 進入 Personal Access Tokens 頁面。
3. 點擊“生成新令牌”按鈕。
4. 勾選所需的權限，然後點擊“生成令牌”。
5. 複製令牌並保存到安全位置。

在Claude Desktop中使用

Docker配置

# 安裝Docker
curl -fsSL https://get.docker.com | bash -s docker

# 運行MCP服務器
docker run -it --rm -p 8080:8080 mcp-server:latest

NPX配置

npm install -g mcp-cli
mcp serve

構建說明

使用以下命令構建Docker鏡像：

docker build -t mcp-server . && docker tag mcp-server:latest yourname/mcp-server:latest

📄 許可證

GitHub MCP 服務器遵循 MIT 許可證。有關詳細信息，請參閱許可文件。