JIRA MCP 服务器
一个 MCP 服务器,支持大型语言模型 (LLM) 通过标准化工具和上下文与 JIRA 交互。此服务器提供使用 JQL 搜索问题以及检索问题详细信息的功能。
特征
JQL 搜索:执行复杂的 JQL 查询并支持分页
问题详情:检索有关特定 JIRA 问题的详细信息
Related MCP server: Python Jira MCP Server
先决条件
npm安装具有 API 访问权限的 JIRA 实例
JIRA API 令牌或个人访问令牌
与 API 令牌关联的 JIRA 用户电子邮件
获取 JIRA API 凭证
通过https://id.atlassian.com登录您的 Atlassian 帐户
导航至安全设置
在 API 令牌下,选择“创建 API 令牌”
给你的令牌一个有意义的名字(例如,“MCP 服务器”)
复制生成的令牌 - 您将无法再次看到它!
使用此令牌作为您的
JIRA_API_KEY使用与您的 Atlassian 帐户关联的电子邮件地址作为
JIRA_USER_EMAIL
用法
与 Claude Desktop 集成
将服务器配置添加到 Claude Desktop 的配置文件中:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json
重新启动 Claude Desktop 以加载新配置。
可用工具
1. JQL 搜索( jql_search )
使用可自定义参数执行 JQL 搜索查询。
参数:
jql(必需):JQL 查询字符串nextPageToken:分页令牌maxResults:返回的最大结果数fields:要包含的字段名称数组expand:要包含的附加信息
例子:
2. 获取问题( get_issue )
检索有关特定问题的详细信息。
参数:
issueIdOrKey(必需):问题 ID 或密钥fields:要包含的字段名称数组expand:要包含的附加信息properties:要包含的属性数组failFast:是否在发生错误时快速失败
例子:
发展
配置
在运行服务器之前设置环境变量。在根目录中创建一个.env文件:
将值替换为:
您实际的 JIRA 实例 URL
与您的 JIRA 帐户关联的电子邮件地址
您的 JIRA API 令牌(可以在 Atlassian 帐户设置中生成)
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 JIRA:
手动安装
克隆此存储库:
安装依赖项:
使用 MCP Inspector 运行
对于测试和开发,您可以使用 MCP Inspector:
添加新工具
要添加新工具,请修改index.js中的ListToolsRequestSchema处理程序:
然后在CallToolRequestSchema处理程序中实现该工具。
执照
麻省理工学院
贡献
欢迎贡献!请随时提交 PR。