工作看板服务

ACM Workboard MCP是一个集成Jira和GitHub任务管理的工作看板服务,适用于开发团队跟踪和管理任务进度。

  • by yiraeChristineKim
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 yiraeChristineKim/workboardMcp

使用说明

ACM工作板MCP

[!重要] 目前,Jira和GitHub的观察列表已存储 仅在内存中.
如果重新启动服务器,您的监视列表将被清除。

启动你的工作板

1.创建一个 .env 文件

  • 复制模板:重复 .env.template 到 .env 在项目根中。
  • Jira设置:
    • JIRA_HOST:例如。 issues.redhat.com.
    • JIRA_API_TOKEN公司:从以下位置创建Jira个人访问令牌
      Jira个人访问令牌页面
      并将其粘贴到 JIRA_API_TOKEN.
  • GitHub设置:
    • GITHUB令牌:GitHub个人访问令牌(见以下步骤)。
    • GITHUB用户:您的GitHub用户名(例如, yiraeChristineKim).
  • 可选端口:
    • API端口(_PORT):仪表板API+UI的端口(默认为 4501).
    • 端口:HTTP MCP服务器的端口(默认为 4000).
    • 前端端口:如果单独运行前端,则为Vite-dev服务器的端口(默认为 5173).

为了得到一个 GitHub个人访问令牌:

  • 步骤1–转到设置
    在GitHub中,单击您的个人资料图片(右上角)→ 设置.
  • 步骤2–开发人员设置
    左侧边栏→ 开发人员设置 → 个人访问令牌.
    选择其中之一 细粒度代币 (推荐)或 代币(经典) 只有当你特别需要一个经典代币时。
  • 步骤3–创建令牌
    点击 生成新令牌.
    命名令牌,设置过期时间,并选择所需的存储库访问权限和权限/范围(例如, repo, read:org).
  • 第4步-安全复制和存储
    复制令牌一次(您将不会再看到它)。
    将其存储在密码管理器中或作为环境变量(例如, GITHUB_TOKEN=...),以及 永远不要将其提交给git.

2.在Cursor中添加您的MCP服务器

  • 打开光标设置 → 工具和MCP → click 新建MCP服务器.
  • 在...之下 mcpServers,添加a workboard-jira 进入。你的 mcp.json 看起来类似于:
{
  "mcpServers": {
    "workboard-jira": {
      "command": "npx",
      "args": ["tsx", "/Users/your-user/Documents/GitHub/workboardMcp/src/stdio_entry.ts"],
      "cwd": "/Users/your-user/Documents/GitHub/workboardMcp",
      "env": {
        "JIRA_HOST": "issues.redhat.com",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "{{JIRA_TOKEN}}",
        "GITHUB_TOKEN": "{{GITHUB_TOKEN}}",
        "GITHUB_USER": "your-github-username"
      }
    }
  }
}
  • 替换 带有您自己值的路径、电子邮件和令牌占位符。

3.构建前端

从项目根:

cd src/frontend
npm install
npm run build

4.启动仪表板API+UI

从项目根:

npm install
npm start

这将启动API服务器,并在 http://localhost:4501 (或您配置的 API_PORT).

5.打开仪表板

  • 浏览器首选 http://localhost:4501.

MCP使用示例

  • Jira观察名单:
    “找到我报告的Jira问题,状态正在进行中,然后将问题添加到我的观察列表中。”
  • GitHub公关观察列表:
    “在stolostorn/config策略控制器下找到GitHub PR,受让人是我,然后将PR添加到我的观察列表中。”
  • 清洁观察名单:
    “清理我所有的观察名单。”
  • 从观察列表中删除特定的Jira问题:
    “从我的Jira观察名单中删除ACM-1111。”