使用说明
MCP Jira服务器
最低限度 模型上下文协议（MCP） 服务器公开：
- 工具:
jira_my_issues–返回未解决的Jira问题 锁定 到christopher.hill@ecu.edu.au（除非你在代码中更改它）。 - 资源:
jira://issue/{key}–获取单个问题的完整JSON。
配合使用效果很好 MCP检查员, VS代码复制代理，以及其他MCP兼容客户端。
1） 先决条件
- Node.js 18+ （建议使用v20）
确认：
node -v - 吉拉云 API令牌，用于对您的项目具有读取访问权限的用户
- npm （与Node捆绑在一起）
- MCP检查员 （通过安装
npx在本指南中）
2） 安装
git clone <this-repo>
cd mcp-jira
npm i
3） 配置环境
创建一个 .env 项目根目录中的文件，其中包含：
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token
JIRA_BASE_URL=https://your-domain.atlassian.net
替换为您的Jira电子邮件、API令牌和基本URL。
4） 运行服务器
npm start
默认情况下，服务器在端口3000上侦听。
5） 使用MCP检查员进行测试
全局安装MCP检查器：
npm i -g @model-context/mcp-inspector
运行：
mcp-inspector --url http://localhost:3000
探索暴露的工具和资源。
6） 使用 jira_my_issues 工具
此工具返回分配给配置用户的未解决Jira问题。
请求示例：
{
"tool": "jira_my_issues",
"input": {}
}
Copilot聊天呼叫示例：
@jira tool:jira_my_issues {}
6a）使用 jira_find_users 工具
查找与查询字符串匹配的Jira用户。
请求示例：
{
"tool": "jira_find_users",
"input": {
"query": "hill"
}
}
Copilot聊天呼叫示例：
@jira tool:jira_find_users {"query":"hill"}
6b）使用 jira_assignable_users 工具
列出可分配给项目的用户（例如“BAM”）。
请求示例：
{
"tool": "jira_assignable_users",
"input": {
"project": "BAM"
}
}
Copilot聊天呼叫示例：
@jira tool:jira_assignable_users {"projectKey":"BAM","query":"hill"}
6c）使用 jira_create_issue 工具
在项目中创建新的Jira问题（例如“BAM”）。
请求示例：
{
"tool": "jira_create_issue",
"input": {
"project": "BAM",
"summary": "Example issue summary",
"description": "Detailed description of the issue.",
"issueType": "Task"
}
}
Copilot聊天呼叫示例：
@jira tool:jira_create_issue {"projectKey":"BAM","summary":"Example issue summary","description":"Detailed description of the issue.","issueType":"Task"}
7） 使用 jira://issue/{key} 资源
按键获取Jira问题的完整JSON。
示例资源URL：
jira://issue/PROJ-123
8） 自定义用户
更改用户 jira_my_issues，编辑 src/index.ts 并更新电子邮件。
9） 扩展服务器
通过修改添加其他工具或资源 src/index.ts.
10） 部署
在任何兼容Node.js的环境中部署。
11） 故障排除
- 检查环境变量。
- 验证Jira API令牌和权限。
- 确保与Jira的网络连接。
12） 贡献
请随时提交问题或拉取请求。
13） 许可证
MIT许可证。
14） 联系方式
克里斯托弗·希尔christopher.hill@ecu.edu.au