Python Jira MCP 服务器

这是一个用 Python 实现的 Model Context Protocol (MCP) 服务器，它与 Jira API 集成。这使得 AI 模型能够通过标准化协议与 Jira 进行交互。

概述

此 MCP 服务器将 Jira API 操作作为工具暴露出来，这些工具可以被支持 Model Context Protocol 的 AI 模型使用。该服务器实现了 stdio 传输机制，以与像 Cursor 这样的客户端进行通信。

功能

• JQL 搜索工具：使用 JQL 查询搜索 Jira 问题
• 获取问题工具：检索特定 Jira 问题的详细信息
• MCP SDK 集成：兼容官方 MCP Python SDK
• 回退模式：在没有 SDK 可用时提供最小实现
• 环境配置：从环境变量中加载 Jira 凭证

要求

• Python 3.8+
• Jira API 访问权限（API 令牌、电子邮件和域名）
• 所需的 Python 包：
  • mcp（Model Context Protocol Python SDK）
  • aiohttp（用于 HTTP 请求）
  • pydantic（用于验证）
  • python-dotenv（用于环境变量）

安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/python-jira-mcp.git
   cd python-jira-mcp
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 设置您的 Jira 凭证：

   cp .env.example .env
   # 使用您的 Jira 凭证编辑 .env 文件
   

使用

运行服务器

要启动 MCP 服务器，请运行：

python main.py

或者直接使用可执行文件：

./main.py

服务器将启动并监听标准输入（stdin）上的 MCP 消息，并在标准输出（stdout）上响应。

与 Cursor 集成

要将此 MCP 服务器与 Cursor 一起使用：

1. 启动服务器（如上所述）
2. 在 Cursor 中，将 MCP 服务器路径配置为指向 main.py
3. 直接在 Cursor 中使用 Jira 工具

可用工具

JQL 搜索

使用 JQL（Jira 查询语言）搜索 Jira 问题。

示例：

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

获取问题

通过 ID 或键检索特定 Jira 问题的详细信息。

示例：

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

开发

项目结构

• main.py：MCP 服务器的入口点
• src/server.py：主要的 MCP 服务器实现
• src/tools/jira_tools.py：Jira API 工具实现
• src/tool_schemas.py：工具模式定义

添加新工具

要添加一个新的与 Jira 相关的工具：

1. 在 src/tools/jira_tools.py 中实现工具函数
2. 在 src/tool_schemas.py 中添加工具模式
3. 在 src/server.py 中注册工具

许可

该项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

致谢

• Model Context Protocol
• Python MCP SDK
• Atlassian Jira API