Jira MCP服务器
使用FastMCP构建的用于与Jira交互的模型上下文协议（MCP）服务器。
特性
- 🎯 问题管理：创建、阅读、搜索和更新Jira问题
- 📋 项目运营：列出项目和项目元数据
- 🔍 高级搜索：JQL（Jira查询语言）支持复杂查询
- 👥 用户管理：获取用户信息和受让人详细信息
- 🏷️ 状态和转换：查看和更新问题状态
- 🔗 评论：添加和检索问题注释
安装
使用紫外线（推荐）
uv pip install -e .使用pip
pip install -e .配置
- 复制示例环境文件：
cp .env.example .env- 编辑
.env使用您的Jira凭据：
JIRA_SERVER=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token获取Jira API代币
- 首选 Atlassian帐户设置
- 点击“创建API令牌”
- 给它一个标签（例如“MCP服务器”）
- 将生成的令牌复制到您的
.env文件
用法
运行服务器
# Using the installed script
jira-mcp
# Or run directly
python -m jira_mcp.server
# Development mode with auto-reload
fastmcp dev jira_mcp/server.py与Claude Desktop一起使用
安装服务器以与Claude Desktop一起使用：
fastmcp install jira_mcp/server.py这将自动将服务器添加到您的Claude Desktop配置中。
交互示例
连接到Claude或其他MCP客户端后，您可以：
- “在ABC项目中创建一个名为“登录页面不工作”的新错误问题”
- “显示分配给的所有未决问题john.doe@company.com"
- “搜索摘要中包含‘数据库’的优先级高的问题”
- “在ABC-123问题上添加注释，说明‘在最新部署中已修复’”
- “XYZ项目的可用状态是什么？”
可用工具
问题管理
create_issue-创建新的Jira问题get_issue-获取有关问题的详细信息update_issue-更新现有问题search_issues-使用JQL搜索问题add_comment-向问题添加评论get_comments-获取某个问题的所有评论
项目运营
list_projects-列出所有可访问的项目get_project-获取详细的项目信息get_project_statuses-获取项目的可用状态
用户管理
search_users-搜索用户get_current_user-获取当前用户信息
可用资源
动态资源
jira://issue/{issue_key}-获取详细的问题信息jira://project/{project_key}-获取项目详细信息jira://user/{username}-获取用户信息
静态资源
jira://projects-列出所有项目jira://current-user-当前用户信息
发展
设置开发环境
# Clone the repository
git clone
cd jira-mcp
# Install dependencies
uv sync --dev
# Install pre-commit hooks
pre-commit install运行测试
pytest代码格式化
black jira_mcp/
isort jira_mcp/类型检查
mypy jira_mcp/建筑
该服务器使用FastMCP构建，并提供：
- Jira客户端：处理身份验证和API通信
- 工具功能：每个MCP工具都映射到特定的Jira操作
- 资源处理程序：提供对Jira数据的只读访问
- 错误处理：通过用户友好的消息进行全面的错误处理
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 添加测试
- 运行测试套件
- 提交拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
故障排除
常见问题
- 身份验证错误：在中验证您的API令牌和电子邮件
.env - 连接问题：检查您的Jira服务器URL
- 权限错误：确保您的API令牌具有足够的权限
调试模式
运行调试日志：
JIRA_MCP_DEBUG=1 python -m jira_mcp.server支持
对于问题和疑问：