GitHub仓库浏览服务

一个用于从Claude.ai浏览公共GitHub仓库的MCP服务器,无需GitHub令牌,支持7种工具操作。

  • by Yog-Sotho
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 Yog-Sotho/github-mcp-server-claudeai

使用说明

github mcp服务器——Claude.ai版本

用于浏览的MCP服务器 公共 Claude.ai的GitHub存储库。使用 流式HTTP 传输——将其部署到托管平台一次,然后将Claude.ai连接到URL。

不需要GitHub令牌。所有7个工具都适用于开箱即用的公共仓库。

工具

工具 说明
github_get_repo 单个仓库的完整元数据
github_list_user_repos 用户/组织仓库的分页列表
github_search_repos 使用GitHub查询语法搜索
github_list_branches 分支名称、SHA、保护状态
github_list_commits 提交可按路径、作者、日期过滤
github_get_file 读取文件或列出目录
github_get_tree 完整递归文件树

5分钟内部署(铁路——推荐)

铁路是最简单的零配置选项。

  1. 将此文件夹推送到GitHub仓库(或分叉)
  2. 首选 railway应用程序 → 新项目→ 从GitHub仓库部署
  3. 选择您的仓库——Railway自动检测节点并运行 npm run build && npm start
  4. 部署后,复制公共URL(例如。 https://github-mcp-server-production.up.railway.app)

替代方案:渲染

  1. 新建Web服务→ 连接您的GitHub仓库
  2. 构建命令: npm install && npm run build
  3. 启动命令: npm start
  4. 复制公共URL

替代品:Fly.io

npm install
npm run build
fly launch          # follow prompts
fly deploy
fly status          # get your app URL

连接到Claude.ai

  1. 首选 claude.ai→ 设置→ 集成
  2. 点击 添加集成
  3. 输入您部署的URL /mcp 附:
    https://your-app-url.railway.app/mcp
    
  4. 点击 保存 --Claude将自动检测并列出所有7个工具

本地测试(部署前)

npm install
npm run build
npm start
# Server runs at http://localhost:3000
# Test: curl http://localhost:3000/health

使用 MCP检查员 在本地测试工具:

npx @modelcontextprotocol/inspector http://localhost:3000/mcp

添加GitHub令牌(可选-将速率限制从60提高到5000 req/小时)

集 GITHUB_TOKEN 作为宿主平台上的环境变量,然后更新 src/services/github.ts 将其纳入 Authorization 头球

"Authorization": process.env.GITHUB_TOKEN ? `Bearer ${process.env.GITHUB_TOKEN}` : "",

铁路上:设置→ 变量→ Add GITHUB_TOKEN = ghp_your_token_here


与Claude Code版本的差异

克劳德代码版本 Claude.ai版本(此文件)
传输 stdio(本地进程) 可流式HTTP(远程服务器)
托管 在您的计算机上运行 部署到铁路/渲染/飞行
配置 claude_desktop_config.json Claude.ai设置→ 集成
工具 相同7个工具 相同的7个工具