Atlassian Jira MCP Server

基本能力

产品定位

Atlassian Jira MCP Server 是一个连接 AI 助手与 Jira 实例的桥梁，旨在提升开发协作和项目管理效率。

核心功能

1. 最小输入，最大输出：仅需简单标识符即可返回全面的 Jira 数据。
2. 完整的 Jira 上下文：提供项目、问题、评论和相关元数据的完整视图。
3. 丰富的开发信息：包括分支、提交和拉取请求等开发相关数据。
4. 安全的本地认证：凭证仅在本地存储和使用，确保安全性。
5. 直观的 Markdown 响应：所有响应均以结构化的 Markdown 格式呈现。

适用场景

1. 项目管理：快速查看项目状态、问题和任务分配。
2. 开发协作：获取与问题相关的开发信息，如提交和分支。
3. 自动化报告：通过 AI 生成项目或问题的自动化报告。
4. 实时查询：使用 JQL 查询实时获取问题或项目数据。

工具列表

1. list_projects：列出可用的 Jira 项目，支持过滤和分页。
2. get_project：获取特定项目的详细信息，包括组件和版本。
3. list_issues：根据 JQL 查询列出匹配的问题。
4. get_issue：获取特定问题的详细信息，包括评论和开发链接。
5. search：使用 JQL 进行高级搜索。

常见问题解答

1. 如何获取 API 令牌？：从 Atlassian 的 API 令牌管理页面创建并复制令牌。
2. 如何配置凭证？：通过 MCP 配置文件或环境变量设置。
3. 如何连接 AI 助手？：在 MCP 兼容客户端中配置服务器启动命令。

使用教程

使用依赖

1. Node.js (>=18.x)：下载链接
2. Atlassian 账户：需有 Jira Cloud 访问权限。

安装教程

1. 获取 API 令牌： bash 访问 https://id.atlassian.com/manage-profile/security/api-tokens 创建并复制令牌。
2. 配置凭证：
3. 方法 A：编辑 ~/.mcp/configs.json 文件： json { "@aashari/mcp-server-atlassian-jira": { "environments": { "ATLASSIAN_SITE_NAME": "<YOUR_SITE_NAME>", "ATLASSIAN_USER_EMAIL": "<YOUR_ATLASSIAN_EMAIL>", "ATLASSIAN_API_TOKEN": "<YOUR_COPIED_API_TOKEN>" } } }
4. 方法 B：通过环境变量运行： bash ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" \ ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \ ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \ npx -y @aashari/mcp-server-atlassian-jira
5. 连接 AI 助手：在客户端配置中设置服务器启动命令： json { "mcpServers": { "aashari/mcp-server-atlassian-jira": { "command": "npx", "args": ["-y", "@aashari/mcp-server-atlassian-jira"] } } }

调试方式

1. 全局安装： bash npm install -g @aashari/mcp-server-atlassian-jira
2. 运行命令： bash mcp-atlassian-jira list-projects mcp-atlassian-jira get-issue --issue PROJ-123
3. 查看帮助： bash mcp-atlassian-jira --help mcp-atlassian-jira get-project --help

许可证

该项目遵循 ISC 开源许可条款。