Atlassian Jira MCP 服务器

本项目提供了一个模型上下文协议 (MCP) 服务器，它充当 AI 助手（如 Anthropic 的 Claude、Cursor AI 或其他 MCP 兼容客户端）和您的 Atlassian Jira 实例之间的桥梁。它允许 AI 安全地访问和实时地与您的项目、问题和其他 Jira 资源进行交互。

---

概述

什么是 MCP？

模型上下文协议 (MCP) 是一个开放标准，允许 AI 系统安全地、有上下文地连接到外部工具和数据源。

此服务器专门为 Jira Cloud 实现了 MCP，将您的 Jira 数据与 AI 助手连接起来。

为什么使用此服务器？

• 最小输入，最大输出理念：只需要简单的标识符，如 projectKeyOrId 和 issueIdOrKey。每个工具都会返回全面的详细信息，而无需额外的标志。

• 完整的 Jira 上下文：为您的 AI 助手提供对项目、问题、评论和所有相关元数据的完全可见性，以了解您的工作上下文。

• 丰富的开发信息：获取与问题关联的分支、提交和拉取请求的详细信息，从而在问题跟踪和代码存储库之间建立桥梁。

• 安全的本地身份验证：凭据永远不会存储在服务器中。服务器在本地运行，因此您的令牌永远不会离开您的机器，并且您可以仅请求所需的权限。

• 直观的 Markdown 响应：所有响应都使用结构良好的 Markdown，具有一致的格式和导航链接，以提高可读性。

---

开始使用

前提条件

• Node.js (>=18.x): 下载
• 具有 Jira Cloud 访问权限的 Atlassian 帐户

---

步骤 1：获取您的 Atlassian API 令牌

1. 转到您的 Atlassian API 令牌管理页面： https://id.atlassian.com/manage-profile/security/api-tokens
2. 单击创建 API 令牌。
3. 给它一个描述性的标签（例如，mcp-jira-access）。
4. 单击创建。
5. 立即复制生成的 API 令牌。您将无法再次看到它。

---

步骤 2：配置凭据

方法 A：MCP 配置文件（推荐）

创建或编辑 ~/.mcp/configs.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>"
		}
	}
}

• <YOUR_SITE_NAME>：您的 Jira 站点名称（例如，mycompany 对于 mycompany.atlassian.net）。
• <YOUR_ATLASSIAN_EMAIL>：您的 Atlassian 帐户电子邮件。
• <YOUR_COPIED_API_TOKEN>：来自步骤 1 的 API 令牌。

方法 B：环境变量

在运行服务器时直接传递凭据：

ATLASSIAN_SITE_NAME="<YOUR_SITE_NAME>" \
ATLASSIAN_USER_EMAIL="<YOUR_EMAIL>" \
ATLASSIAN_API_TOKEN="<YOUR_API_TOKEN>" \
npx -y @aashari/mcp-server-atlassian-jira

---

步骤 3：连接您的 AI 助手

配置您的 MCP 兼容客户端以启动此服务器。

Claude / Cursor 配置：

{
	"mcpServers": {
		"aashari/mcp-server-atlassian-jira": {
			"command": "npx",
			"args": ["-y", "@aashari/mcp-server-atlassian-jira"]
		}
	}
}

此配置在运行时自动启动服务器。

---

工具

本节介绍将此服务器与 AI 助手一起使用时可用的 MCP 工具。请注意，MCP 工具对工具名称使用 snake_case，对参数使用 camelCase。

list_projects

列出可用的 Jira 项目，并可选择过滤和分页。

{}

或：

{ "name": "Platform" }

"显示我所有的 Jira 项目。"

---

get_project

获取特定项目的完整详细信息，包括组件和版本。

{ "projectKeyOrId": "DEV" }

或：

{ "projectKeyOrId": "10001" }

"告诉我 Jira 中 DEV 项目的信息。"

---

list_issues

列出与 JQL（Jira 查询语言）查询匹配的问题，并进行分页。

{ "jql": "project = DEV AND status = 'In Progress'" }

或：

{ "jql": "assignee = currentUser() AND resolution = Unresolved" }

"查找分配给我的 DEV 项目中未解决的错误。"

---

get_issue

获取特定问题的全面详细信息，包括描述、评论和链接的开发信息。

{ "issueIdOrKey": "PROJ-123" }

或：

{ "issueIdOrKey": "10001" }

"显示我问题 PROJ-123 的所有详细信息和链接的提交。"

---

search

使用 JQL（Jira 查询语言）搜索 Jira 内容以进行高级过滤。

{ "jql": "text ~ 'login issue'" }

或：

{ "jql": "project = PROJ AND priority = High AND created >= startOfMonth()" }

"搜索 PROJ 项目中本月创建的高优先级问题。"

---

命令行界面 (CLI)

CLI 对命令（例如，list-projects）和选项（例如，--project）使用 kebab-case。

使用 npx 快速使用

npx -y @aashari/mcp-server-atlassian-jira list-projects
npx -y @aashari/mcp-server-atlassian-jira get-issue --issue PROJ-123

全局安装

npm install -g @aashari/mcp-server-atlassian-jira

然后直接运行：

mcp-atlassian-jira list-projects

发现更多 CLI 选项

使用 --help 查看所有可用命令的标志和用法：

mcp-atlassian-jira --help

或获取特定命令的详细帮助：

mcp-atlassian-jira get-project --help
mcp-atlassian-jira list-issues --help
mcp-atlassian-jira search --help

---

许可证

ISC 许可证