使用说明
github问题跟踪器
MCP(模型上下文协议)服务器,与 GitHub REST API 因此,助手可以列出、分类、创建、评论和关闭问题,并为存储库提取每周风格的活动摘要。内置于 MCPize、快递和 @octokit/rest.
配置
创建一个 .env 文件(参见 .env.example 为了 PORT / NODE_ENV). 需要用于GitHub API调用:
GITHUB_TOKENA. GitHub个人访问令牌 具有适合您使用的存储库的范围(例如repo对于私有存储库,或public_repo仅供公众使用)。
服务器读取 GITHUB_TOKEN 启动时通过 dotenv.
快速开始
npm install
# Set GITHUB_TOKEN in .env, then:
npm run dev # Start with hot reload
- MCP(流式HTTP):
POST http://localhost:8080/mcp(默认端口来自PORT,通常8080) - 健康:
GET http://localhost:8080/health--JSON{ "status": "healthy" }(适用于Cloud Run等平台)
发展
npm run dev # Development mode with hot reload
npm run build # Compile TypeScript
npm test # Run tests
npm start # Run compiled server
工具
所有工具都将存储库视为 owner / repo (GitHub owner/name).
| 工具 | 目的 |
|---|---|
list_issues |
最多可列出10个 问题 (拉取请求除外),可选 state: open, closed,或 all. |
triage_issue |
获取一个问题并添加一个标签: bug 如果标题或正文中出现“bug”(不区分大小写),否则 enhancement. |
weekly_digest |
总结过去7天:更新问题、更新PR和提交(文本摘要加结构化计数和列表)。 |
add_comment |
对某个问题或公关发表评论(issue_Number, body). |
create_issue |
打开一个新问题,可选 body, labels, assignees,以及 milestone. |
close_issue |
关闭一个问题;可选的 state_reason: completed 或 not_planned. |
处理程序返回人类可读的结果 content 和 structuredContent 对于支持结构化工具结果的客户。
对于检查员,请连接到 http://localhost:8080/mcp (或您部署的URL)。
部署
mcpize deploy
配置 GITHUB_TOKEN (以及任何其他秘密)保存在MCPize仪表板或主机环境中,以便服务器可以向GitHub进行身份验证。
