使用说明
Jira MCP
A. 模型上下文协议(MCP) Jira Cloud的服务器。使AI助手能够管理问题、冲刺、项目等。
快速开始
npx @icy-r/jira-mcp
MCP配置
添加到您的MCP客户端(Claude Desktop、Cursor等):
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "@icy-r/jira-mcp"],
"env": {
"JIRA_BASE_URL": "https://your-domain.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}
获取您的API令牌: 大西洋API代币
环境变量
| 变量 | 描述 | 必填 |
|---|---|---|
JIRA_BASE_URL |
Jira实例URL | 是 |
JIRA_EMAIL |
您的Atlassian电子邮件 | 是 |
JIRA_API_TOKEN |
API令牌 | 是 |
JIRA_MCP_USE_TOON |
启用TOON格式 | 否 |
工具
| 工具 | 操作 |
|---|---|
jira_issues |
获取、创建、更新、删除、搜索、转换、分配 |
jira_projects |
列表、获取、获取状态、获取版本、创建版本 |
jira_sprints |
列表、获取、获取问题、获取活动、创建、更新 |
jira_boards |
列表、get、get_config、get_issues、get_backlog |
jira_comments |
列表、获取、添加、更新、删除 |
jira_links |
get_link_types、列表、创建、删除 |
jira_worklogs |
列表、添加、更新、删除 |
jira_users |
get_current、get、search、get_assignable |
jira_fields |
列表、list_custom、搜索、get_id |
jira_audit |
get_status、set_dry_run、get_session_log |
搜索预设
{ "action": "search", "preset": "my_sprint_issues" }
可用: my_issues, current_sprint, my_sprint_issues, recently_updated, high_priority, due_soon
安全功能
破坏性行为需要确认:
{ "action": "delete", "issueKey": "PROJ-123", "confirm": true }
使用模拟运行预览更改:
{ "action": "update", "issueKey": "PROJ-123", "summary": "New title", "dryRun": true }
发展
git clone https://github.com/icy-r/jira-mcp.git
cd jira-mcp
pnpm install
pnpm build
pnpm test
许可证
麻省理工学院
