npm @aaronsb/jira-cloud-mcpstdioupdated 8d ago
A Model Context Protocol server for interacting with Jira Cloud instances.
Jira Cloud 能做什么?
Jira Cloud MCP Server
A Model Context Protocol server for interacting with Jira Cloud instances.
Install
Claude Desktop (one-click)
Download jira-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Jira credentials.
Claude Code
claude mcp add jira-cloud -e JIRA_API_TOKEN=your-token -e JIRA_EMAIL=your-email -e JIRA_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/jira-cloud-mcp
Manual (any MCP client)
{
"mcpServers": {
"jira-cloud": {
"command": "npx",
"args": ["-y", "@aaronsb/jira-cloud-mcp"],
"env": {
"JIRA_API_TOKEN": "your-api-token",
"JIRA_EMAIL": "your-email",
"JIRA_HOST": "https://your-team.atlassian.net"
}
}
}
}
Credentials
Generate an API token at Atlassian Account Settings.
Tools
| Tool | Description |
|---|---|
manage_jira_issue |
Get, create, update, delete, move, transition, comment on, link, or traverse hierarchy of issues |
manage_jira_filter |
Search for issues using JQL queries, or manage saved filters |
manage_jira_project |
List projects or get project configuration and metadata |
manage_jira_board |
List boards or get board details and configuration |
manage_jira_sprint |
Manage sprints: create, start, close, and assign issues to sprints |
queue_jira_operations |
Batch multiple operations with result references ($0.key) and error strategies |
analyze_jira_issues |
Compute metrics, exact counts, and data cube analysis over issues selected by JQL |
Each tool accepts an operation parameter (except queue_jira_operations which takes an operations array, and analyze_jira_issues which takes jql + metrics). Per-tool documentation is available as MCP resources at jira://tools/{tool_name}/documentation.
See docs/tools.md for detailed tool descriptions, workspace patterns, and design principles.
MCP Resources
| Resource | Description |
|---|---|
jira://instance/summary |
Instance-level statistics |
jira://projects/distribution |
Project distribution overview |
jira://projects/{key}/overview |
Project overview with status counts |
jira://boards/{id}/overview |
Board overview with sprint info |
jira://issue-link-types |
Available issue link types |
jira://custom-fields |
Custom field catalog (auto-discovered at startup) |
jira://custom-fields/{project}/{issueType} |
Context-specific custom fields |
jira://analysis/recipes |
Analysis query patterns and compute DSL reference |
jira://tools/{name}/documentation |
Per-tool documentation |
License
安装
把 Jira Cloud 添加到你的客户端。选择你正在使用的那个。
claude mcp add jira-cloud-mcp -- npx -y @aaronsb/jira-cloud-mcpcodex mcp add jira-cloud-mcp -- npx -y @aaronsb/jira-cloud-mcpamp mcp add jira-cloud-mcp -- npx -y @aaronsb/jira-cloud-mcp{
"mcpServers": {
"jira-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"jira-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"jira-cloud-mcp","command":"npx","args":["-y","@aaronsb/jira-cloud-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"jira-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"jira-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"jira-cloud-mcp": {
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"jira-cloud-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"jira-cloud-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@aaronsb/jira-cloud-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @aaronsb/jira-cloud-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
7 个工具
Jira Cloud 向已连接的智能体提供 7 个工具。
- manage_jira_issue
- Get, create, update, delete, move, transition, comment on, link, or traverse hierarchy of issues
- manage_jira_filter
- Search for issues using JQL queries, or manage saved filters
- manage_jira_project
- List projects or get project configuration and metadata
- manage_jira_board
- List boards or get board details and configuration
- manage_jira_sprint
- Manage sprints: create, start, close, and assign issues to sprints
- queue_jira_operations
- Batch multiple operations with result references (`$0.key`) and error strategies
- analyze_jira_issues
- Compute metrics, exact counts, and data cube analysis over issues selected by JQL
评分
71 / 100
良好
- 文档22/25
- 维护25/25
- 可信度6/20
- 能力6/15
- 安装体验12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 7 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.11.2最新 | 2026年8月31日 |
| 0.10.0 | 2026年4月2日 |
| 0.5.5 | 2026年3月9日 |
| 0.5.4 | 2026年3月7日 |
| 0.5.3 | 2026年3月7日 |
| 0.5.2 | 2026年3月7日 |
| 0.5.1 | 2026年3月7日 |
| 0.5.0 | 2026年3月7日 |
| 0.4.3 | 2026年3月6日 |
| 0.4.2 | 2026年3月6日 |
| 0.4.1 | 2026年3月6日 |
| 0.4.0 | 2026年3月6日 |
| 0.3.1 | 2026年3月6日 |