
Python Jira MCP Server

2025.03.06
0
PythonJira 集成AI 模型交互任务管理交流协作开发效率
Python Jira MCP Server 是一个基于 Python 实现的 Model Context Protocol (MCP) 服务器,用于与 Jira API 集成。它允许 AI 模型通过标准化协议与 Jira 进行交互。该服务器通过 stdio 传输机制与客户端(如 Cursor)通信,提供了 JQL 搜索、获取问题详情等功能。
View on GitHub
Overview
基本能力
产品定位
Python Jira MCP Server 是一个用于与 Jira API 集成的 MCP 服务器,旨在为 AI 模型提供与 Jira 交互的标准化接口。
核心功能
- JQL 搜索工具:使用 JQL 查询搜索 Jira 问题
- 获取问题工具:检索特定 Jira 问题的详细信息
- MCP SDK 集成:与官方 MCP Python SDK 兼容
- 回退模式:在 SDK 不可用时提供最小实现
- 环境配置:从环境变量加载 Jira 凭据
适用场景
- 在 AI 模型中集成 Jira 问题管理功能
- 通过标准化协议与 Jira 进行交互
- 开发与 Jira 集成的自动化工具
工具列表
- JQL Search Tool:使用 JQL 查询搜索 Jira 问题
- Get Issue Tool:检索特定 Jira 问题的详细信息
常见问题解答
- 如何配置 Jira 凭据?:通过编辑
.env
文件设置 Jira 凭据 - 如何添加新工具?:在
src/tools/jira_tools.py
中实现工具函数,并在src/tool_schemas.py
中添加工具模式
使用教程
使用依赖
- 确保安装 Python 3.8+
- 获取 Jira API 访问权限(API 令牌、电子邮件和域名)
- 安装必要的 Python 包:
bash pip install mcp aiohttp pydantic python-dotenv
安装教程
- 克隆仓库:
bash git clone https://github.com/yourusername/python-jira-mcp.git cd python-jira-mcp
- 安装依赖:
bash pip install -r requirements.txt
- 设置 Jira 凭据:
bash cp .env.example .env # 编辑 .env 文件设置 Jira 凭据
调试方式
- 启动 MCP 服务器:
bash python main.py
- 在 Cursor 中配置 MCP 服务器路径指向
main.py
- 在 Cursor 中直接使用 Jira 工具