Python Jira MCP Server

Python Jira MCP服务器

Python中的模型上下文协议（MCP）服务器实现，与Jira API集成。这允许AI模型通过标准化协议与Jira进行交互。

概述

此MCP服务器将Jira API操作公开为支持模型上下文协议的AI模型可以使用的工具。服务器实现了stdio传输机制，以与Cursor等客户端通信。

特性

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

需求

• Python 3.8+
• Jira API访问（API令牌、电子邮件和域）
• 所需的Python包：

- mcp （模型上下文协议Python SDK） - aiohttp （用于HTTP请求） - pydantic （用于验证） - python-dotenv （环境变量）

安装

1. 克隆此存储库：

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

1. 安装依赖项：

   pip install -r requirements.txt

1. 设置您的Jira凭据：

   cp .env.example .env
   # Edit .env with your Jira credentials

用法

运行服务器

要启动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"]
  }
}

获取问题

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

例子：

{
  "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许可证获得许可-有关详细信息，请参阅许可证文件。

致谢

• 模型上下文协议
• Python MCP SDK
• Atlassian Jira API