使用说明
ACM工作板MCP
[!重要] 目前,Jira和GitHub的观察列表已存储 仅在内存中.
如果重新启动服务器,您的监视列表将被清除。
启动你的工作板
1.创建一个 .env 文件
- 复制模板:重复
.env.template到.env在项目根中。 - Jira设置:
- JIRA_HOST:例如。
issues.redhat.com. - JIRA_API_TOKEN公司:从以下位置创建Jira个人访问令牌
Jira个人访问令牌页面
并将其粘贴到JIRA_API_TOKEN.
- JIRA_HOST:例如。
- GitHub设置:
- GITHUB令牌:GitHub个人访问令牌(见以下步骤)。
- GITHUB用户:您的GitHub用户名(例如,
yiraeChristineKim).
- 可选端口:
- API端口(_PORT):仪表板API+UI的端口(默认为
4501). - 端口:HTTP MCP服务器的端口(默认为
4000). - 前端端口:如果单独运行前端,则为Vite-dev服务器的端口(默认为
5173).
- API端口(_PORT):仪表板API+UI的端口(默认为
为了得到一个 GitHub个人访问令牌:
- 步骤1–转到设置
在GitHub中,单击您的个人资料图片(右上角)→ 设置. - 步骤2–开发人员设置
左侧边栏→ 开发人员设置 → 个人访问令牌.
选择其中之一 细粒度代币 (推荐)或 代币(经典) 只有当你特别需要一个经典代币时。 - 步骤3–创建令牌
点击 生成新令牌.
命名令牌,设置过期时间,并选择所需的存储库访问权限和权限/范围(例如,repo,read:org). - 第4步-安全复制和存储
复制令牌一次(您将不会再看到它)。
将其存储在密码管理器中或作为环境变量(例如,GITHUB_TOKEN=...),以及 永远不要将其提交给git.
2.在Cursor中添加您的MCP服务器
- 打开光标设置 → 工具和MCP → click 新建MCP服务器.
- 在...之下
mcpServers,添加aworkboard-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。”