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
   # 在 .env 文件中编辑您的 Jira 凭据
   

使用方法

运行服务器

要启动 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: 服务器主程序
• tools/: 包含 Jira 工具的目录
• requirements.txt: 依赖项列表
• .env.example: 示例环境变量文件

贡献指南

1. 克隆仓库：

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

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 启动服务器进行测试：

   python main.py
   

4. 开始开发并提交更改。

许可证

该项目在 LICENSE 下发布。

联系方式

如有任何问题或建议，请联系 your.email@example.com。