🔗 JIRA MCP Server for Cursor

---

✨ 特性

• 📋 从 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 检查器是一个用于测试和调试 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 服务器：

1. 构建并运行您的服务器：

   npm run build  # 在运行项目之前必须构建项目
   node dist/index.js
   

2. 配置 Claude Desktop：

   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

3. 添加 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"
         }
       }
     }
   }
   

4. 重启 Claude Desktop 并使用以下命令进行测试：

   现在几点了？
   

   或者

   显示分配给我的 JIRA 问题。
   

🔌 与 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	运行测试

📘 资源

• Model Context Protocol 文档
• MCP TypeScript SDK
• MCP 规范
• MCP 检查器

📄 许可证

MIT © Stanislav Stepanenko

---