🚀 Jira MCP 服务器
Jira MCP 服务器允许您通过自然语言与 Jira 进行对话，轻松获取项目信息并对项目进行修改。它可以与 Claude 桌面结合使用，还能创建包含项目信息的自定义 README，助力您委托 PM 任务。例如，若您有团队成员及其专长列表，就能将新问题分配给最适合的人员。该服务器基于 Model Context Protocol 构建。
🚀 快速开始
若要使用此 MCP 服务器与 Claude 桌面交互，可按以下步骤操作：
- 找到您的 Claude 桌面配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
- 将 Jira MCP 服务器添加到您的配置中：
{ "mcp_servers": [ { "name": "jira-server", "command": "npm start", "cwd": "/path/to/jira-server", "env": { "JIRA_HOST": "your-instance.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } ] }/path/to/jira-server替换为您克隆仓库的实际路径。 - 重新启动 Claude 桌面以应用更改。
✨ 主要特性
- 项目创建和配置
- 问题及子任务管理
- 问题链接与依赖关系
- 自动化问题工作流
📦 安装指南
所需环境变量：
JIRA_HOST: 您的 Jira 实例主机名JIRA_EMAIL: 您的 Jira 账户电子邮件JIRA_API_TOKEN: 来自 https://id.atlassian.com/manage-profile/security/api-tokens 的 API 令牌
💻 使用示例
基础用法
1. 用户管理
// 通过电子邮件获取用户的账户 ID
{
email: "user@example.com";
}
2. 问题类型管理
// 列出所有可用的问题类型
// 返回：id、名称、描述、子任务状态
// 不需要参数
3. 问题链接类型
// 列出所有可用的问题链接类型
// 返回：id、名称、 inward/outward 描述
// 不需要参数
4. 问题管理
获取问题
// 获取项目中的所有问题
{
projectKey: "PROJECT"
}
// 获取单个问题的详细信息
{
issueIdOrKey: "issues/ABC-123"
}
创建问题
// 创建新问题
{
method: POST,
body: {
fields: {
project: { key: "project_key" },
issuetype: { name: "Task" },
title: "问题标题",
description: "问题描述"
}
}
}
更新问题
// 更新现有问题
{
method: PUT,
body: {
fields: {
status: { name: "已解决" },
priority: { name: "高" },
assignee: { email: "user@example.com" }
}
}
}
删除问题
// 删除问题
{
method: DELETE
}
高级用法
在实际使用中，您可以根据不同的业务场景灵活组合上述工具，实现更复杂的项目管理需求。例如，结合用户管理和问题管理，将新问题自动分配给合适的人员。
📚 详细文档
描述字段
描述字段支持以下格式：
- 标题: 使用
#标记标题，如# 这是标题 - 段落: 直接输入文本即可，如
这是段落内容。 - 列表: 使用
-创建无序列表，如：- 第一个列表项
- 第二个列表项
- 代码块: 使用反引号
\`` 包裹代码，如：console.log("Hello, World!"); - 强调: 使用
*或_创建强调文本，如*这是强调文字*_ - 链接: 使用
[文本](URL)创建超链接，如[访问官网](https://www.example.com)
错误处理
- 400 错误: 请求格式有误或缺少参数
- 401 错误: 未授权，检查 API 令牌是否有效
- 404 错误: 资源不存在
- 500 错误: 服务器内部错误
📄 许可证
文档中未提及许可证相关信息。