JIRA MCP 服务器
一个 MCP 服务器,支持大型语言模型 (LLM) 通过标准化工具和上下文与 JIRA 交互。此服务器提供使用 JQL 搜索问题以及检索问题详细信息的功能。
特征
- JQL 搜索:执行复杂的 JQL 查询并支持分页
- 问题详情:检索有关特定 JIRA 问题的详细信息
先决条件
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。
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
提供使用 JQL 搜索Jira问题并检索详细问题信息的功能。
Related MCP Servers
- AsecurityFlicenseAqualityProvides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.Last updated -66JavaScript
- -securityFlicense-qualityEnables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.Last updated -2TypeScript
- -securityFlicense-qualityA server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.Last updated -Python
- AsecurityAlicenseAqualityA TypeScript-based server that enables interaction with Jira, providing tools to execute JQL queries, manage tickets, list projects and statuses through natural language.Last updated -1120JavaScriptMIT License