🔗 用于 Cursor 的 JIRA MCP 服务器

✨ 特点

• 📋直接从 Cursor 访问 JIRA

  • 无需离开 IDE 即可查看分配的问题

  • 使用一个命令获取有关特定问题的详细信息

  • 将 JIRA 问题无缝转换为本地任务

• ⏰系统时间集成

  • 可自定义的日期和时间格式

  • 通过 date-fns 支持区域设置

Related MCP server: JIRA MCP Server

🚀 快速入门

安装

# 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 服务器：

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

   npm run build  # You must build the project before running it
   node dist/index.js

2. 配置Claude桌面：

   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 并测试：

   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 工具

系统时间工具

📁 项目结构

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

NPM 脚本

📘 资源

• 模型上下文协议文档

• MCP TypeScript SDK

• MCP 规范

• MCP 检查器

📄 许可证

麻省理工学院© Stanislav Stepanenko