Github Meta MCP Server

🚀 GitHub MCP 服務器

這是一個模型上下文協議 (MCP) 服務器，為用戶提供了與 GitHub API 交互的實用工具。目前，它支持依據描述、主題以及網站 URL 來創建倉庫，極大地提升了倉庫創建與管理的效率。

🚀 快速開始

此服務器可助力你便捷地與 GitHub API 交互，實現倉庫的創建與管理。

✨ 主要特性

• 能夠根據描述自動生成名稱，快速創建 GitHub 倉庫。
• 可輕鬆為倉庫添加主題或標籤，便於分類管理。
• 支持設置倉庫主頁，展示項目相關信息。
• 會自動初始化倉庫，並生成 README 文件，為項目提供基礎說明。

📦 安裝指南

1. 克隆代碼庫：

   git clone https://github.com/your-repository.git
   

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 倉庫。

命令格式

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

• 創建倉庫：

Create a repository for [描述] with tags [標籤1 標籤2 標籤3] website [url]

或者

Make a new repository called [描述] tagged with [標籤1, 標籤2, 標籤3]

• 更新倉庫描述：

Update [owner/repo] description to [新描述]

或者

Change [repo-name] description as [新描述]

• 更新倉庫標籤：

Update [owner/repo] tags to [標籤1 標籤2 標籤3]

或者

Set [repo-name] topics as [標籤1, 標籤2, 標籤3]

• 更新倉庫主頁：

Update [owner/repo] website to [url]

或者

Set [repo-name] homepage as [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 相關內容
});