用于 Cursor 的 JIRA MCP 服务器

🔗 用于 Cursor 的 JIRA MCP 服务器

✨ 特点

📋直接从 Cursor 访问 JIRA
- 无需离开 IDE 即可查看分配的问题
- 使用一个命令获取有关特定问题的详细信息
- 将 JIRA 问题无缝转换为本地任务
⏰系统时间集成
- 可自定义的日期和时间格式
- 通过 date-fns 支持区域设置

🚀 快速入门

安装

# Clone the repository
git clone https://github.com/Dsazz/mcp-jira.git
cd mcp-jira

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

配置

使用以下变量创建.env文件：

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 关于 JIRA API 令牌的重要说明
令牌可能包含特殊字符，包括=符号
将令牌放在.env文件中的一行上
不要在令牌值周围添加引号
按照 Atlassian 提供的方式粘贴令牌

🛠️ 开发工具

MCP 检查器

MCP Inspector 是用于测试和调试 MCP 服务器的强大工具。

# Run the inspector (no separate build step needed)
npm run inspect

检查员自动：

从.env加载环境变量
清理占用的端口（5175、3002）
在需要时构建项目
使用您的配置启动 MCP 服务器
启动检查器 UI

访问检查器http://localhost:5175?proxyPort=3002

如果遇到端口冲突：

npm run cleanup-ports

使用检查器进行调试

检查器 UI 允许您：

查看所有可用的 MCP 功能
执行工具并检查响应
分析 JSON 通信
使用不同的参数进行测试

有关更多详细信息，请参阅MCP Inspector GitHub 存储库。

与 Claude Desktop 集成

直接使用 Claude 测试您的 MCP 服务器：

构建并运行您的服务器：
npm run build # You must build the project before running it node dist/index.js
配置Claude桌面：
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
添加 MCP 配置：
{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }
重新启动 Claude Desktop 并测试：
What time is it right now?
或者
Show me my assigned JIRA issues.

🔌 与 Cursor IDE 集成

**⚠️重要提示：**在与 Cursor IDE 或 Claude Desktop 集成之前，您必须使用npm run build构建项目。

将此 MCP 服务器添加到您的 Cursor IDE 的 MCP 配置中：

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 可用工具

JIRA 工具

工具	描述	参数	返回
`jira_get_assigned_issues`	检索分配给您的所有问题	没有任何	Markdown 格式的问题列表
`jira_get_issue`	获取有关特定问题的详细信息	`issueKey` ：发行密钥（例如 PD-312）	Markdown 格式的问题详情
`jira_create_task`	从 JIRA 问题创建本地任务	`issueKey` ：发行密钥（例如 PD-312）	Markdown 格式的任务

系统时间工具

工具	描述	参数	返回
`get_system_time`	获取当前系统时间	`format` ：（可选）date-fns 格式字符串	格式化的日期/时间字符串

📁 项目结构

src/
 ├── features/        # MCP features (JIRA, system time)
 ├── server/          # MCP server implementation
 ├── shared/          # Shared utilities
 └── index.ts         # Main entry point

NPM 脚本

命令	描述
`npm run build`	构建项目
`npm run publish`	构建并发布包到 npm 注册表
`npm run inspect`	使用 MCP 检查器运行进行调试
`npm run cleanup-ports`	检查员使用的释放端口
`npm test`	运行测试

📘 资源

📄 许可证

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

模型上下文协议服务器将 JIRA 直接集成到 Cursor IDE 中，允许用户查看分配的问题、获取特定票证的详细信息，并将 JIRA 问题转换为本地任务，而无需离开编辑器。

Related MCP Servers

MCP Atlassian
sooperset
A
security
A
license
A
quality
Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
Last updated -
27
2,005
Python
MIT License
MCP Server for Cursor
AntDX316
-
security
F
license
-
quality
A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
690
1
Python
HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
JIRA MCP Server
klauseduard
-
security
F
license
-
quality
A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
Last updated -
Python

View all related MCP servers

JIRA MCP Server