使用说明
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": "Your email",
"JIRA_API_KEY": "KEY_FROM : https://id.atlassian.com/manage-profile/security/api-tokens"
}
}
}
}
调试
由于MCP服务器通过stdio进行通信，调试可能会具有挑战性。我们建议使用 MCP 检查器，这可以作为一个包脚本使用：
npm run inspector
检查员将提供一个URL，以便您在浏览器中访问调试工具。