🔗 用于 Cursor 的 JIRA MCP 服务器

Name: JIRA MCP Server
Author: Dsazz

✨ 特点

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

Related MCP server: MCP Server for Cursor

🚀 快速入门

安装

# 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`	运行测试