GitHub问题跟踪服务

一个与GitHub REST API交互的MCP服务器,用于列出、分类、创建、评论和关闭问题,并提供仓库的每周活动摘要。

  • by Samiislam851
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Samiislam851/issue-tracker-mcp

使用说明

github问题跟踪器

MCP(模型上下文协议)服务器,与 GitHub REST API 因此,助手可以列出、分类、创建、评论和关闭问题,并为存储库提取每周风格的活动摘要。内置于 MCPize、快递和 @octokit/rest.

配置

创建一个 .env 文件(参见 .env.example 为了 PORT / NODE_ENV). 需要用于GitHub API调用:

  • GITHUB_TOKEN A. 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进行身份验证。