MCP 服务器

Python Jira MCP Server

一个服务器实现，允许 AI 模型通过模型上下文协议与 Jira 交互，从而实现诸如 JQL 搜索和检索问题详情等任务。

通信

开发者工具

Python

访问服务器

README

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 token, email, 和 domain)
必需的 Python 包:
- mcp (Model Context Protocol Python SDK)
- aiohttp (用于 HTTP 请求)
- pydantic (用于验证)
- python-dotenv (用于环境变量)

安装

克隆此仓库:

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

安装依赖项:
```
pip install -r requirements.txt
```

设置您的 Jira 凭据:

cp .env.example .env
# 编辑 .env 文件，填入您的 Jira 凭据

使用

运行服务器

要启动 MCP 服务器，运行:

python main.py

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

./main.py

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

与 Cursor 集成

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

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

可用工具

JQL 搜索

使用 JQL (Jira Query Language) 搜索 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 或 key 检索关于特定 Jira 问题的详细信息。

示例:

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