MCP Jira 27c61d3d

MCP办公协作

提供方 webboy

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方 Cursor
查看接入方式

一个基于Python的Jira Cloud REST API v3服务,提供问题管理(CRUD、搜索、转换、评论、附件)功能,使AI客户端(如Cursor)能够安全地自动化Jira工作流程。

一句话选型结论

按资料字段整理

MCP Jira 27c61d3d 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Jira自动化Python本地部署RESTAPI问题管理工作流自动化AI集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Jira 27c61d3d当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方webboy上游标注的维护方 webboy
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.4 KB
来自项目仓库与上游目录的原文,未做删改

mcp-jira

Python MCP server for Jira Cloud (REST API v3), built with FastMCP and atlassian-python-api. It exposes tools for issue management (CRUD, search, transitions, comments, attachments) so AI clients (e.g., Cursor) can safely automate Jira workflows.

Requirements

  • Python 3.10+
  • uv (pipx install uv or follow uv docs)
  • Jira Cloud account with API token
  • Create API token at: https://id.atlassian.com/manage-profile/security/api-tokens

Install (editable)```bash

uv pip install -e .


### Docker Usage (HTTP/SSE Transport)

The MCP server runs in a Docker container using HTTP/SSE transport, allowing a single long-running container that handles multiple Cursor connections.

#### Quick Start

1. **Create environment file:**```bash
cp .env.example .env
# Edit .env with your Jira credentials
  1. Build and start the container:```bash
    docker-compose up -d --build

3. **Configure Cursor** (`~/.cursor/mcp.json`):```json
{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:9001/sse"
    }
  }
}
  1. Restart Cursor - The Jira MCP server should now be available!

Manual Docker Commands

Build the image:```bash
docker build -t mcp-jira:latest .


**Run with docker-compose:**```bash
# Start in background
docker-compose up -d

# View logs
docker-compose logs -f

# Stop
docker-compose down

Run with docker directly:```bash
docker run -d \
--name mcp-jira \
-p 9001:9001 \
-e JIRA_URL=https://your-domain.atlassian.net \
-e JIRA_EMAIL=your.email@example.com \
-e JIRA_API_TOKEN=your_api_token \
-e JIRA_DEFAULT_PROJECT=PROJ \
-e MCP_TRANSPORT=sse \
mcp-jira:latest


#### Health Check

Verify the server is running:```bash
curl http://localhost:9001/sse

Container Management```bash

Check if running

docker ps | grep mcp-jira

View logs

docker logs mcp-jira

Restart

docker restart mcp-jira

Stop and remove

docker stop mcp-jira
docker rm mcp-jira


#### Benefits of HTTP/SSE Transport

- **Single container**: One long-running container handles all requests
- **Multiple connections**: Cursor can connect/reconnect without spawning new containers
- **Better performance**: No container startup overhead per request
- **Easier debugging**: View logs with `docker logs`
- **Health monitoring**: Built-in health checks

#### Multi-Project Setup

If you work on multiple Jira instances with different credentials, you can run multiple containers:

**Setup:**
1. Create project-specific env files:```bash
cp .env.project1.example .env.project1
cp .env.project2.example .env.project2
# Edit each with the appropriate credentials
  1. Start both containers:```bash
    docker compose -f docker-compose.project1.yml up -d
    docker compose -f docker-compose.project2.yml up -d

3. Configure Cursor with both servers:```json
{
  "mcpServers": {
    "jira-project1": {
      "url": "http://localhost:9001/sse"
    },
    "jira-project2": {
      "url": "http://localhost:9002/sse"
    }
  }
}

Management:```bash

Start all projects

docker compose -f docker-compose.project1.yml up -d
docker compose -f docker-compose.project2.yml up -d

Stop specific project

docker compose -f docker-compose.project1.yml down

View logs for specific project

docker compose -f docker-compose.project1.yml logs -f


### Configuration
Environment variables:
- JIRA_URL: Your Jira Cloud instance URL (e.g., `https://your-company.atlassian.net`)
- JIRA_EMAIL: Your Jira account email
- JIRA_API_TOKEN: API token from https://id.atlassian.com/manage-profile/security/api-tokens
- JIRA_DEFAULT_PROJECT: Default project key (optional but convenient)
- FASTMCP_LOG_LEVEL: DEBUG · INFO · ... (optional)

### Run (stdio server)```bash
JIRA_URL='https://your-domain.atlassian.net' \
JIRA_EMAIL='your.email@example.com' \
JIRA_API_TOKEN='your_api_token' \
JIRA_DEFAULT_PROJECT='PROJ' \
uv run mcp-jira

The server uses stdio and prints little until a client connects.

Debug with MCP Inspector

Expose a FastMCP instance via src/app.py and launch the Inspector:```bash
JIRA_URL='https://your-domain.atlassian.net' \
JIRA_EMAIL='your.email@example.com' \
JIRA_API_TOKEN='your_api_token' \
JIRA_DEFAULT_PROJECT='PROJ' \
uv run --with mcp mcp dev src/app.py --with-editable .

Open the printed URL and call tools like `health` and `getProjects`.

### Use with Cursor (Native/Development)

#### Option 1: Docker (Recommended for Production)
See Docker Usage section above.

#### Option 2: Direct UV (for Development)
If Cursor runs inside the same Ubuntu WSL2 environment, prefer an absolute path to `uv` and add editable source to ensure the local tree is used:```json
{
  "mcpServers": {
    "jira": {
      "command": "/home/nemanja/.local/bin/uv",
      "args": ["run", "--with-editable", "/home/nemanja/projects/mcp/mcp-jira", "mcp-jira"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your.email@example.com",
        "JIRA_API_TOKEN": "your_api_token",
        "JIRA_DEFAULT_PROJECT": "PROJ",
        "FASTMCP_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Option 3: WSL Bridge (Windows)

If Cursor runs on Windows (outside WSL), bridge to WSL via:```json
{
"mcpServers": {
"jira": {
"command": "wsl",
"args": [
"bash", "-lc",
"cd /home/<user>/projects/mcp/mcp-jira && JIRA_URL='https://your-domain.atlassian.net' JIRA_EMAIL='your.email@example.com' JIRA_API_TOKEN='your_api_token' JIRA_DEFAULT_PROJECT='PROJ' /home/<user>/.local/bin/uv run mcp-jira"
]
}
}
}


### Tools (high-level)

**Health &amp; Configuration:**
- `health` - Validate configuration and Jira connectivity

**Issue Operations:**
- `getIssue` - Get detailed information about an issue
- `createIssue` - Create a new issue with summary, description, type, priority, assignee, labels
- `updateIssue` - Update issue fields (summary, description, priority, assignee, labels)
- `searchIssues` - Search issues using JQL (Jira Query Language)

**Transitions &amp; Workflow:**
- `getTransitions` - Get available status transitions for an issue
- `transitionIssue` - Move issue to a different status (e.g., To Do → In Progress)

**Comments:**
- `addComment` - Add a comment to an issue
- `getComments` - Get all comments for an issue

**Attachments:**
- `addAttachment` - Add a file attachment to an issue (base64-encoded)

**Project &amp; Metadata:**
- `getProjects` - List all accessible projects
- `getProject` - Get detailed information about a specific project
- `getIssueTypes` - Get available issue types for a project

All tools return MCP-compatible responses (JSON with success/error status).

### Common Use Cases

**Create an issue:**```
Use the createIssue tool:
- project: &quot;PROJ&quot;
- summary: &quot;Implement new feature&quot;
- description: &quot;Detailed description here&quot;
- issue_type: &quot;Task&quot;

Search for issues:```
Use the searchIssues tool with JQL:
- jql: "project = PROJ AND status = 'In Progress'"
- max_results: 10


**Transition an issue:**```
1. First, use getTransitions to see available transitions
2. Then use transitionIssue with the transition ID

Add a comment:Use the addComment tool: - issue_key: &quot;PROJ-123&quot; - comment: &quot;Work in progress, will update soon&quot;

Troubleshooting

No tools in client:
- Ensure the command actually starts in your environment (absolute path to uv helps)
- Add FASTMCP_LOG_LEVEL=DEBUG to see detailed logs
- Check that all required environment variables are set

401/403 errors:
- Verify API token is correct and not expired
- Check that your Jira account has proper permissions
- Ensure JIRA_URL is correct (include https://, no trailing slash)

Connection errors:
- Verify JIRA_URL is accessible from your network
- Check if you need to be on VPN for corporate Jira instances
- Test connectivity: curl https://your-domain.atlassian.net

Docker container not starting:
- Check logs: docker logs mcp-jira
- Verify .env file exists and has correct values
- Ensure port 9001 is not already in use

Inspector won't connect:
- Ensure proxy health at http://localhost:6277/health returns { &quot;status&quot;: &quot;ok&quot; }
- If bridging from Windows to WSL, enable localhost forwarding in WSL

Security

  • Treat API tokens as secrets. Never commit them to version control.
  • Use .env files (which are gitignored) for local development
  • For production, use Docker secrets or environment variable injection
  • Rotate API tokens if exposed
  • API tokens at: https://id.atlassian.com/manage-profile/security/api-tokens

License

MIT License - see LICENSE file for details

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Jira 27c61d3d 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

MCP Jira 27c61d3d 怎么在 Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Jira 27c61d3d 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Jira 27c61d3d 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Jira 27c61d3d 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Jira 27c61d3d 能提供哪些能力?

资料显示能力标签包括 工作流自动化、Python、Cursor、问题管理。具体工具清单以官方文档为准。

MCP Jira 27c61d3d 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

MCP Jira 27c61d3d 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。