Jira MCP Fd002581

MCP办公协作

提供方 jimloco

办公协作 未标注 无需鉴权 社区 / 第三方

企业级Jira MCP服务器,提供与Jira Cloud和Server/Data Center的全面集成,支持问题管理、项目导航和工作流自动化。

一句话选型结论

按资料字段整理

Jira MCP Fd002581 属于办公协作类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

Jira集成Python本地部署问题管理工作流自动化项目管理企业级工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

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

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Jira MCP Fd002581当前 3 未标注 未标注 无 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

服务器档案

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

详细介绍

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

> ## ⚠️ IMPORTANT DISCLAIMER
>
> This code is 100% AI-generated. Use at your own risk. The authors make no guarantees about the reliability, security, or fitness for any particular purpose. Thoroughly review and test all code before using in production environments.

Jira MCP Server

> Enterprise-grade Model Context Protocol server for comprehensive Jira Cloud and Server/Data Center integration

A production-ready MCP server that provides AI assistants with complete access to Jira Cloud and Jira Server/Data Center. Enables natural language interaction with Jira for issue management, project navigation, and workflow automation across multiple Jira workspaces.

✨ Features

🏢 Multi-Workspace Management

  • Connect to multiple Jira Cloud and Server/Data Center instances
  • Support for both Cloud (API token) and Server/Data Center (PAT) authentication
  • Seamlessly switch between workspaces
  • XDG-compliant configuration storage (~/.config/jira-mcp/)
  • Secure skeleton file workflow for credential management
  • Workspace validation and credential management

🎫 Complete Issue Lifecycle

  • Search: Powerful JQL-based issue search
  • CRUD Operations: Create, read, update, and delete issues
  • Workflow Management: Transition issues through custom workflows
  • Assignment: Assign issues to team members
  • Custom Fields: Support for custom field manipulation

💬 Collaboration Features

  • Comments: Full CRUD operations on issue comments
  • Attachments: Upload, list, and delete file attachments
  • Links: Create relationships between issues (Relates, Blocks, Duplicate, etc.)
  • Subtasks: Create and manage parent-child task hierarchies

📊 Project & Discovery

  • List all accessible projects
  • Get detailed project information
  • Enumerate available issue types
  • User search for assignments

🚀 Quick Start

Prerequisites

  • Python 3.12+ - Required for modern Python features
  • Poetry - Dependency management
  • Jira Cloud or Server/Data Center - Active instance with API access

Installation```bash

Clone the repository

git clone [repository-url]
cd jira-mcp

Install dependencies with Poetry

poetry install

Start the MCP server

poetry run start-mcp


The server runs using STDIO transport and communicates via the Model Context Protocol.

## 🔧 Configuration

### Configuration Location

All workspace configurations are stored in **`~/.config/jira-mcp/workspaces/`** with secure 600 permissions.

### Getting Your Credentials

**For Jira Cloud:**
1. Navigate to Atlassian API Tokens
2. Click **"Create API token"**
3. Label it (e.g., "AI Assistant MCP")
4. **Copy the token immediately** (you won't be able to view it again!)

**For Jira Server/Data Center:**
1. Generate a Personal Access Token (PAT) from your Jira Server instance
2. Follow your organization's process for PAT creation
3. Copy the token for use in configuration

### Adding a Workspace

**Recommended Method: Skeleton File (Secure)**

Create a skeleton configuration file that you edit directly:```python
# 1. Create skeleton file
jira_workspace(
    operation="create_workspace_skeleton",
    workspace_name="mycompany",
    auth_type="cloud"  # or "pat" for Server/Data Center
)

# 2. Edit the file at ~/.config/jira-mcp/workspaces/mycompany.json
# 3. Fill in your actual credentials
# 4. Remove the _instructions section
# 5. Restart the MCP server

Alternative: Direct Add (Programmatic)

For Jira Cloud:```python
jira_workspace(
operation="add_workspace",
workspace_name="mycompany",
site_url="mycompany.atlassian.net",
email="your.email@company.com",
api_token="YOUR_API_TOKEN_HERE",
auth_type="cloud"
)


For Jira Server/Data Center:```python
jira_workspace(
    operation="add_workspace",
    workspace_name="mycompany",
    site_url="jira.company.com",
    email="your.username",
    api_token="YOUR_PERSONAL_ACCESS_TOKEN",
    auth_type="pat"
)

The server will:
- Validate your credentials
- Test the connection
- Store the configuration securely in ~/.config/jira-mcp/workspaces/mycompany.json
- Set it as the active workspace (if it's your first)

Managing Workspaces```python

List all configured workspaces

jira_workspace(operation="list_workspaces")

Switch to a different workspace

jira_workspace(operation="switch_workspace", workspace_name="otherworkspace")

Get current workspace info

jira_workspace(operation="get_active_workspace")

Validate workspace credentials

jira_workspace(operation="validate_workspace", workspace_name="mycompany")

Remove a workspace

jira_workspace(operation="remove_workspace", workspace_name="oldworkspace")


## 📖 Usage Guide

### 🔍 Searching & Reading Issues

**Search with JQL:**```python
jira_issues(
    operation="search",
    jql="project = ENG AND status = Open AND assignee = currentUser()",
    max_results=50
)

Get issue details:```python
jira_issues(operation="read", issue_key="ENG-123")


**Get available transitions:**```python
jira_issues(operation="get_transitions", issue_key="ENG-123")

✏️ Creating & Updating Issues

Create a new issue:```python
jira_issues(
operation="create",
project_key="ENG",
issue_type="Task",
summary="Implement new feature",
description="Detailed description here",
priority="High",
labels=["backend", "urgent"],
assignee="user@example.com" # Optional
)


**Update an issue:**```python
jira_issues(
    operation="update",
    issue_key="ENG-123",
    summary="Updated task title",
    description="Updated description",
    priority="Medium"
)

Assign an issue:```python
jira_issues(
operation="assign",
issue_key="ENG-123",
assignee="user@example.com"
)


**Transition through workflow:**```python
jira_issues(
    operation="transition",
    issue_key="ENG-123",
    transition="In Progress",
    comment="Starting work on this task"  # Optional
)

💬 Comments

List comments:```python
jira_issues(operation="list_comments", issue_key="ENG-123")


**Add a comment:**```python
jira_issues(
    operation="add_comment",
    issue_key="ENG-123",
    body="This is a comment from the AI assistant"
)

Update a comment:```python
jira_issues(
operation="update_comment",
issue_key="ENG-123",
comment_id="12345",
body="Updated comment text"
)


**Delete a comment:**```python
jira_issues(
    operation="delete_comment",
    issue_key="ENG-123",
    comment_id="12345"
)

📎 Attachments

List attachments:```python
jira_issues(operation="list_attachments", issue_key="ENG-123")


**Upload a file:**```python
jira_issues(
    operation="add_attachment",
    issue_key="ENG-123",
    filepath="/path/to/document.pdf"
)

Delete an attachment:```python
jira_issues(
operation="delete_attachment",
attachment_id="67890"
)


### 🔗 Issue Links & Relationships

**Create a link:**```python
jira_issues(
    operation="create_link",
    inward_issue="ENG-123",
    outward_issue="ENG-456",
    link_type="Blocks"  # or "Relates", "Duplicate", etc.
)

List links:```python
jira_issues(operation="list_links", issue_key="ENG-123")


**Delete a link:**```python
jira_issues(operation="delete_link", link_id="11111")

📋 Subtasks

Create a subtask:```python
jira_issues(
operation="create_subtask",
parent_key="ENG-123",
summary="Subtask: Implement unit tests",
description="Write comprehensive tests",
assignee="developer@example.com" # Optional
)


**List subtasks:**```python
jira_issues(operation="list_subtasks", issue_key="ENG-123")

📊 Projects

List all projects:```python
jira_projects(operation="list")


**Get project details:**```python
jira_projects(operation="get", project_key="ENG")

Get issue types for a project:```python
jira_projects(operation="get_issue_types", project_key="ENG")


### 👥 Users

**Get current user:**```python
jira_workspace(operation="get_current_user")

Search for users:```python
jira_workspace(
operation="search_users",
query="john",
max_results=10
)


## 🏗️ Architecture

### Project Structure```
jira-mcp/
├── jira_mcp/
│   ├── __init__.py           # Package initialization
│   ├── __main__.py           # Entry point for module execution
│   ├── server.py             # Main server & STDIO transport
│   ├── mcp_server.py         # MCP tool registration & routing
│   ├── config.py             # Configuration management
│   ├── workspace_manager.py  # Multi-workspace handling
│   ├── jira_client.py        # Jira API client wrapper
│   └── issue_manager.py      # Issue operations (CRUD, comments, etc.)
├── docs/                     # Documentation
│   └── implementation.md     # Implementation specification
├── pyproject.toml           # Poetry dependencies & config
├── poetry.lock              # Locked dependencies
└── README.md                # This file

~/.config/jira-mcp/          # XDG config directory (created automatically)
├── workspaces/              # Workspace configurations
│   ├── workspace1.json
│   └── workspace2.json
└── active_workspace         # Currently active workspace

MCP Tools

The server exposes 3 MCP tools with 32 total operations:

  1. jira_workspace (10 operations) - Workspace management (includes create_workspace_skeleton)
  2. jira_projects (3 operations) - Project discovery
  3. jira_issues (19 operations) - Complete issue management

Technology Stack

  • Python 3.12+ - Modern Python with type hints
  • MCP SDK - Model Context Protocol implementation
  • Jira Python Library - Official Jira API client
  • Poetry - Dependency management and packaging
  • STDIO Transport - Standard MCP communication protocol

🧪 Development

Code Quality```bash

Run pylint (target: 10.00/10)

poetry run pylint jira_mcp/

Type checking with mypy

poetry run mypy jira_mcp/

Security analysis

poetry run bandit -r jira_mcp/

Dependency security audit

poetry run pip-audit


### Testing```bash
# Run test suite
poetry run pytest

# With coverage
poetry run pytest --cov=jira_mcp

Project Standards

  • Code Quality: Pylint score of 10.00/10 maintained
  • Type Safety: Full type hints with mypy validation
  • Security: Bandit security scanning, no secrets in code
  • Documentation: Comprehensive docstrings for all functions
  • Error Handling: Proper exception handling at all layers

📊 Statistics

  • Total Operations: 32 across 3 MCP tools
  • Lines of Code: ~4,600 production code
  • Code Quality: 10.00/10 pylint score
  • Test Coverage: Manual MCP integration testing
  • Python Version: 3.12+
  • Supported Platforms: Jira Cloud + Jira Server/Data Center

🔒 Security

Best Practices

  • API Tokens: Stored in ~/.config/jira-mcp/workspaces/ with 600 permissions
  • XDG Compliance: Configuration follows XDG Base Directory specification
  • No Secrets in Code: All credentials loaded from configuration files
  • Authentication Types: Supports both Cloud (API token) and Server/Data Center (PAT)
  • Input Validation: All parameters validated before API calls
  • Error Handling: Secure error messages without sensitive data
  • Skeleton Workflow: Recommended approach to avoid passing credentials through tool calls

Workspace Storage

Workspace configurations are stored in ~/.config/jira-mcp/workspaces/*.json with restricted permissions:

Jira Cloud:```json
{
"name": "mycompany",
"site_url": "https://mycompany.atlassian.net",
"email": "user@company.com",
"api_token": "YOUR_API_TOKEN",
"auth_type": "cloud",
"created": "2026-02-05T07:20:00.000000",
"last_validated": null
}


**Jira Server/Data Center:**```json
{
  "name": "myserver",
  "site_url": "https://jira.company.com",
  "email": "username",
  "api_token": "YOUR_PERSONAL_ACCESS_TOKEN",
  "auth_type": "pat",
  "created": "2026-02-05T07:20:00.000000",
  "last_validated": null
}

Security Notes:
- Files are automatically created with 600 permissions (owner read/write only)
- Configuration directory is in user's home directory, not in project repository
- Use create_workspace_skeleton operation to avoid passing credentials via tool calls

🐛 Troubleshooting

Common Issues

"No active workspace" error:```bash

Add a workspace first

jira_workspace(operation="add_workspace", ...)
```

Workspace not loading:
1. Check file exists: ls ~/.config/jira-mcp/workspaces/
2. Check file permissions: ls -la ~/.config/jira-mcp/workspaces/
3. Validate JSON syntax: cat ~/.config/jira-mcp/workspaces/myserver.json | python -m json.tool
4. Restart MCP server (close and reopen your AI assistant)

"Authentication failed" error:
- Verify your API token is correct
- Check that your email matches your Atlassian account
- Ensure the site URL is correct (e.g., company.atlassian.net)
- Verify auth_type matches your Jira instance (Cloud vs Server)
- For PAT: Ensure token is valid and not expired
- Test connection: jira_workspace(operation="validate_workspace", workspace_name="myserver")

"Invalid JQL" error:
- Test your JQL in Jira's web interface first
- Ensure field names are correct (case-sensitive)
- Check for proper quoting of values

File attachment upload fails:
- Verify the file path exists and is readable
- Check file size limits (Jira defaults to 10MB)
- Ensure you have attachment permissions in the project

Multiple workspaces:
- Only one workspace can be active at a time
- Use switch_workspace to change between workspaces
- Active workspace is stored in ~/.config/jira-mcp/active_workspace

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Maintain 10.00/10 pylint score
  5. Add tests for new functionality
  6. Push to the branch (git push origin feature/amazing-feature)
  7. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built with the Model Context Protocol
  • Uses the Jira Python Library
  • Developed with Poetry

📞 Support

For issues, questions, or contributions:
- Open an issue on GitHub
- Check the docs/ directory for detailed documentation
- Review docs/implementation.md for technical details


Made with ❤️ for AI-powered Jira management

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Jira MCP Fd002581 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Jira MCP Fd002581 收费吗?

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

Jira MCP Fd002581 需要 API Key 吗?

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

Jira MCP Fd002581 能提供哪些能力?

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

热门专题

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

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