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 （环境变量）
安装
- 克隆此存储库：
git clone https://github.com/yourusername/python-jira-mcp.git
cd python-jira-mcp- 安装依赖项：
pip install -r requirements.txt- 设置您的Jira凭据：
cp .env.example .env
# Edit .env with your Jira credentials用法
运行服务器
要启动MCP服务器，请运行：
python main.py或者直接使用可执行文件：
./main.py服务器将启动并监听标准输入（stdin）上的MCP消息，并在标准输出（stdout）上做出响应。
与Cursor集成
要将此MCP服务器与Cursor一起使用，请执行以下操作：
- 启动服务器（如上所述）
- 在Cursor中，配置MCP服务器路径以指向
main.py - 直接在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相关工具：
- 在中实现工具功能
src/tools/jira_tools.py - 在中添加工具架构
src/tool_schemas.py - 在中注册该工具
src/server.py
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。