Jira通信服务器 MCP服务器
与Jira交互
这是一个基于TypeScript的MCP服务器,提供与Jira交互的工具。它通过提供以下功能展示了核心MCP概念:
- 执行JQL查询的工具
- 创建、编辑和删除Jira工单的工具
- 列出Jira项目和状态的工具
功能
Jira工具
execute_jql
- 用途:运行JQL查询
- 参数:
jql,number_of_results(默认:1)
get_only_ticket_name_and_description
- 用途:获取工单名称和描述
- 参数:
jql,number_of_results(默认:1)
create_ticket
- 用途:创建Jira工单
- 参数:
project.key,summary,description,issuetype.name,parent(可选)
list_projects
- 用途:列出Jira项目
- 参数:
number_of_results(默认:1)
delete_ticket
- 用途:删除工单
- 参数:
issueIdOrKey
edit_ticket
- 用途:修改工单
- 参数:
issueIdOrKey,summary(可选),description(可选),labels(可选),parent(可选)
get_all_statuses
- 用途:获取所有状态
- 参数:
number_of_results(默认:1)
assign_ticket
- 用途:将工单分配给用户
- 参数:
accountId,issueIdOrKey
query_assignable
- 用途:查找项目中的可分配用户
- 参数:
project_key
add_attachment_from_public_url
- 用途:从公共URL向工单添加附件
- 参数:
issueIdOrKey,imageUrl
add_attachment_from_confluence
- 用途:从Confluence页面向工单添加附件
- 参数:
issueIdOrKey,pageId,attachmentName
开发
安装依赖:
npm install
构建服务器:
npm run build
用于开发并自动重建:
npm run watch
安装
要在Claude Desktop中使用,请添加服务器配置:
在MacOS上:~/Library/Application Support/Claude/claude_desktop_config.json
在Windows上:%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"Jira communication server": {
"command": "node",
"args": ["/PATH_TO_THE_PROJECT/build/index.js"],
"env": {
"JIRA_URL": "https://XXXXXXXX.atlassian.net",
"JIRA_API_MAIL": "您的邮箱",
"JIRA_API_KEY": "来自 https://id.atlassian.com/manage-profile/security/api-tokens 的KEY"
}
}
}
}
调试
由于MCP服务器通过stdio通信,调试可能具有挑战性。我们建议使用MCP Inspector,它作为包脚本提供:
npm run inspector
Inspector将提供一个URL,您可以在浏览器中访问调试工具。