使用说明
Jira MCP
MCP服务器用于Jira Cloud集成,使Claude能够管理PWP工作项。
特性
- 搜索问题 JQL(Jira查询语言)
- 获取问题详细信息 完整的上下文
- 创建问题 具有完整的层次结构支持(Epic→ Task → 子任务)
- 更新问题 -修改字段、优先级、受让人
- 添加评论 记录决策和进展
- 过渡问题 通过工作流状态
- 获取过渡 -发现可用的工作流选项
- 删除问题 -安全确认后的清理(⚠️ 永久)
安装
cd ~/dev/jira-mcp
# Create virtual environment
uv venv
source .venv/bin/activate
# Install dependencies
uv pip install -e .
配置
1.设置凭据
生成加密密钥:
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
设置环境变量:
export JIRA_ENCRYPTION_KEY='your-generated-key'
运行安装脚本:
python scripts/setup_credentials.py
2.配置克劳德桌面
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"jira-pwp": {
"command": "uv",
"args": [
"--directory",
"/Users/mike/dev/jira-mcp",
"run",
"jira-mcp"
],
"env": {
"JIRA_ENCRYPTION_KEY": "your-encryption-key"
}
}
}
}
3.重新启动克劳德桌面
Jira工具将出现在工具面板中。
快速开始
搜索问题
Search for open issues in ITHELP
创建问题
Create a task in ITPROJ to review the Q1 budget
更新问题
Set ITPROJ-42 to high priority
转型是一个问题
Move ITPROJ-42 to In Progress
项目
| 项目 | 目的 | 问题类型 |
|---|---|---|
| ITPROJ | IT项目 | 史诗、任务、子任务 |
| ITHELP | IT帮助台 | 服务请求、事件、问题 |
| ITCM | 变更管理 | (各不相同) |
文档
- 用法.md -带示例的完整工具参考
- API-QUIRKS.md公司 -Jira API gotchas和字段格式
发展
# Run tests
python -m pytest tests/
# Test connection
python scripts/test_connection.py
# Run server directly
python -m jira_mcp.server
许可证
麻省理工学院