Github Repository Manager

🚀 GitHub MCP 服務器

GitHub MCP 服務器是一個基於模型上下文協議（MCP）的工具，它能與 GitHub API 進行交互。目前，該服務器支持根據描述、主題和網址來創建倉庫，為開發者提供了便捷的倉庫管理方式。

🚀 快速開始

GitHub MCP 服務器允許你通過自然語言命令與 GitHub API 交互，輕鬆創建和管理倉庫。下面將為你詳細介紹使用前的安裝和配置步驟。

✨ 主要特性

• 自動命名創建倉庫：根據輸入的描述自動生成合適的名稱，快速創建 GitHub 倉庫。
• 主題/標籤添加：為創建的倉庫添加主題或標籤，方便對倉庫進行分類和檢索。
• 主頁設置：可自定義倉庫的主頁，展示倉庫的相關信息。
• 自動初始化：創建倉庫時，自動初始化帶有 README 文件的倉庫，為項目提供基礎說明。

📦 安裝指南

1. 克隆倉庫：將項目倉庫克隆到本地。
2. 安裝依賴項：在項目根目錄下，執行以下命令安裝所需依賴：

npm install

3. 構建服務器：安裝完依賴後，構建服務器：

npm run build

📚 詳細文檔

配置說明

該服務器需要一個具有倉庫創建權限的 GitHub 個人訪問令牌。你需要將以下內容添加到 MCP 設置文件中：

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["path/to/github-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

可用工具

create_repo

此工具可使用自然語言命令創建或更新 GitHub 倉庫。

命令格式

該工具支持多種自然語言命令來執行不同操作：

• 創建倉庫：

為 [描述] 創建一個倉庫，帶有標籤 [tag1 tag2 tag3] 網站 [url]

或者

新建一個名為 [描述] 的倉庫，並添加標籤 [tag1, tag2, tag3]

• 更新倉庫描述：

將 [owner/repo] 描述更改為 [新描述]

或者

將 [repo-name] 的描述設置為 [新描述]

• 更新倉庫標籤：

將 [owner/repo] 標籤更改為 [tag1 tag2 tag3]

或者

將 [repo-name] 的主題設置為 [tag1, tag2, tag3]

• 更新倉庫網站：

將 [owner/repo] 網站更改為 [url]

或者

將 [repo-name] 的主頁設置為 [url]

示例用法

• 創建新倉庫：

const result = await use_mcp_tool({
  server_name: "github",
  tool_name: "create_repo",
  arguments: {
    command: "Create a repository for my machine learning image classifier with tags python tensorflow computer-vision website https://example.com/docs"
  }
});

這將完成以下操作：

1. 創建名為 "my-machine-learning-image-classifier" 的倉庫。
2. 設置描述為 "my machine learning image classifier"。
3. 添加 "python", "tensorflow" 和 "computer-vision" 作為倉庫主題。
4. 設置網站為 "https://example.com/docs"。
5. 初始化帶 README 文件的倉庫。

• 更新倉庫描述：

const result = await use_mcp_tool({
  server_name: "github",
  tool_name: "create_repo",
  arguments: {
    command: "Update username/existing-repo description to Updated ML project for image classification"
  }
});

• 更新倉庫標籤：

const result = await use_mcp_tool({
  server_name: "github",
  tool_name: "create_repo",
  arguments: {
    command: "Update username/existing-repo tags to machine-learning python updated"
  }
});

• 更新倉庫網站：

const result = await use_mcp_tool({
  server_name: "github",
  tool_name: "create_repo",
  arguments: {
    command: "Update username/existing-repo website to https://example.com/new-docs"
  }
});

該工具能夠理解多種自然語言模式和關鍵詞：

• 創建倉庫：Create/make/new
• 更新倉庫：Update/change/set/modify
• 更新描述：description to/as
• 更新主題：tags/topics to/as
• 更新網站：website/url

開發說明

若要修改或擴展服務器代碼，請按以下步驟操作：

1. 修改 src 文件夾中的文件。
2. 在終端運行以下命令進行構建：

npm run build

📄 許可證

本項目採用 MIT 許可證。