Mcpserverjira

Jira MCP服务器

与Jira集成的MCP（模型上下文协议）服务器，允许通过REST API创建和检索票证。

特性

• 使用可自定义字段创建Jira票证
• 通过票密钥检索票信息
• 返回机票号码和完整机票详细信息
• Docker化，易于部署

先决条件

• Docker和Docker Compose
• 带有API令牌的Jira帐户

入门指南

1.获取Jira API代币

1. 首选https://id.atlassian.com/manage-profile/security/api-tokens
2. 点击“创建API令牌”
3. 复制生成的令牌

2.配置环境变量

复制示例环境文件并填写Jira凭据：

cp .env.example .env

编辑 .env 与你的价值观：

• JIRA_BASE_URL：您的Jira实例URL（例如。， https://your-domain.atlassian.net)
• JIRA_EMAIL：您的Jira帐户电子邮件
• JIRA_API_TOKEN：您的Jira API代币

3.使用Docker Compose构建和运行

docker-compose up --build

或者以分离模式运行：

docker-compose up -d --build

4.本地运行（可选）

如果你想在没有Docker的情况下运行：

pip install -r requirements.txt
export JIRA_BASE_URL=https://your-domain.atlassian.net
export JIRA_EMAIL=your-email@example.com
export JIRA_API_TOKEN=your-api-token
python server.py

可用工具

创建jira_ticket

创建新的Jira票证。

所需参数：

• project_key （string）：Jira项目密钥（例如“PROJ”）
• summary （string）：门票摘要/标题
• description （string）：票务描述

可选参数：

• issue_type （string）：问题类型（任务、Bug、故事、史诗等）-默认值：“任务”
• priority （string）：优先级（最高、高、中、低、最低）
• labels （array）：要添加到票证的标签列表
• assignee （string）：受让人的账户ID
• reporter （string）：报告者的账号ID

答复：

{
  "ticket_number": "PROJ-123",
  "ticket_url": "https://your-domain.atlassian.net/browse/PROJ-123",
  "ticket_info": {
    "key": "PROJ-123",
    "summary": "Ticket Title",
    "description": "Ticket description",
    "status": "To Do",
    "issue_type": "Task",
    "priority": "Medium",
    "assignee": "John Doe",
    "reporter": "Jane Smith",
    "created": "2024-01-01T00:00:00.000+0000",
    "updated": "2024-01-01T00:00:00.000+0000",
    "labels": ["label1", "label2"],
    "project": "PROJ"
  }
}

获取jira_ticket

检索有关现有Jira票证的信息。

所需参数：

• ticket_key （string）：Jira票证密钥（例如“PROJ-123”）

答复：

{
  "ticket_number": "PROJ-123",
  "ticket_url": "https://your-domain.atlassian.net/browse/PROJ-123",
  "ticket_info": {
    "key": "PROJ-123",
    "summary": "Ticket Title",
    "description": "Ticket description",
    "status": "In Progress",
    "issue_type": "Task",
    "priority": "High",
    "assignee": "John Doe",
    "reporter": "Jane Smith",
    "created": "2024-01-01T00:00:00.000+0000",
    "updated": "2024-01-02T00:00:00.000+0000",
    "labels": ["label1"],
    "project": "PROJ"
  }
}

示例用法

创建工单

{
  "name": "create_jira_ticket",
  "arguments": {
    "project_key": "PROJ",
    "summary": "Fix login bug",
    "description": "Users cannot log in with email addresses containing plus signs",
    "issue_type": "Bug",
    "priority": "High",
    "labels": ["bug", "authentication"]
  }
}

获取门票信息

{
  "name": "get_jira_ticket",
  "arguments": {
    "ticket_key": "PROJ-123"
  }
}

故障排除

身份验证错误

• 验证您的Jira电子邮件和API令牌是否正确
• 确保您的Jira实例URL正确（包括 https:// 没有尾随斜线）
• 检查您的帐户是否有权在指定项目中创建工单

项目关键错误

• 确保项目密钥存在于Jira实例中
• 项目密钥区分大小写

问题类型错误

• 验证问题类型名称是否完全匹配（例如，“任务”、“Bug”、“故事”）
• 检查问题类型在指定项目中是否可用

许可证

麻省理工学院