GitHub MCP Server Bash

github mcp服务器bash

Github MCP Bash服务器

该项目提供了 GitHub集成服务器 与兼容 MCP（模型上下文协议） 规范。它允许客户端通过标准工具检索GitHub用户统计数据和个人资料信息。

______________________________________________________________________

🛠️ 特性

• 🔍 tool_get_repo_count –返回公共回购计数
• 📊 tool_get_commit_count –返回公共存储库中的总提交计数
• 👤 tool_get_profile_info –返回用户个人资料信息（个人简介、关注者等）

所有工具都使用 GITHUB_USERNAME 和 GITHUB_API_TOKEN 环境变量。

______________________________________________________________________

📁 项目结构

.
├── githubserver.sh                # Main server script
├── assets/
│   ├── githubserver_config.json  # MCP server config
│   └── githubserver_tools.json   # Tool definitions
├── logs/
│   └── githubserver.log          # Log output
└── mcpserver_core.sh             # Core MCP logic (sourced by server)

______________________________________________________________________

⚙️ MCP配置（VS代码）

这是一个样品 mcp.json （由VS Code MCP扩展或环境使用）：

{
  "mcp": {
    "servers": {
      "my-github-server": {
        "type": "stdio",
        "command": "/absolute/path/to/githubserver.sh",
        "args": [],
        "env": {
          "GITHUB_API_TOKEN": "your_github_pat",
          "GITHUB_USERNAME": "Shaamam"
        }
      }
    }
  }
}

🛡️ 备注：确保您的GitHub令牌(GITHUB_API_TOKEN)有 repo 如果需要，可以访问私有存储库，但默认情况下只使用公共存储库。

______________________________________________________________________

🚀 运行服务器

确保所有脚本都是可执行的：

chmod +x githubserver.sh

现在，您可以通过MCP工具链或VS Code扩展启动服务器。

______________________________________________________________________

🧪 可用工具

🔹 tool_get_repo_count

返回中定义的用户的公共存储库数量 GITHUB_USERNAME.

🔹 tool_get_commit_count

返回 总提交计数 在所有公共存储库中。

🔹 tool_get_profile_info

返回GitHub个人资料信息，包括姓名、个人简介、关注者等。

______________________________________________________________________

❗ 需求

• 猛击
• jq
• curl
• 有效的GitHub个人访问令牌