Workboard MCP

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。”