AI导哈

GitHub用户数据查询服务

一个基于MCP协议的GitHub集成服务器，提供用户统计数据和资料信息查询功能。

  • by Shaamam
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 shaamam/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个人访问令牌

相关 MCP