AI导哈

Jira问题上下文协议服务器

提供Jira问题上下文给AI助手的协议服务器，支持获取问题详情、评论及验证连接等功能。

  • by davidgomezcol
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 davidgomezcol/cursor-mcp-server

使用说明

Jira MCP服务器

MCP（模型上下文协议）服务器，为Cursor、VS Code Copilot、Claude Desktop和Codex等AI助手提供Jira问题上下文。

特性

  • get_jira_issue -按密钥获取完整的问题详细信息
  • get_jira_issue_from_branch -从git分支名称中提取Jira密钥并获取详细信息
  • get_jira_comments -获取问题的评论
  • test_jira_connection -验证Jira API连接

每个工具返回：

  • 问题摘要、描述、状态、优先级、受让人
  • 复制步骤 （摘自描述）
  • 近期评论 （最多10个）
  • 组件、标签和元数据

设置

先决条件

  • Python 3.11+
  • 紫外线 -快速Python包管理器
  • 带有API令牌的Jira帐户

安装

  1. 克隆存储库：
git clone <repository-url>
cd cursor-mcp-server
  1. 安装uv（如果尚未安装）：
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or with Homebrew
brew install uv
  1. 安装依赖项：
uv sync

环境变量

创建一个 .env 项目根目录中的文件：

JIRA_SERVER=https://your-company.atlassian.net
JIRA_EMAIL=your-email@company.com
JIRA_API_TOKEN=your-jira-api-token

要创建Jira API令牌，请执行以下操作：

  1. 首选https://id.atlassian.com/manage-profile/security/api-tokens
  2. 点击“创建API令牌”
  3. 复制令牌并将其添加到您的 .env 文件

配置

光标

添加到光标MCP设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/cursor-mcp-server", "python", "-m", "app.main"]
    }
  }
}

VS代码（副本）

添加到您的VS代码设置或 .vscode/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/cursor-mcp-server", "python", "-m", "app.main"]
    }
  }
}

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/cursor-mcp-server", "python", "-m", "app.main"]
    }
  }
}

法典

添加到您的Codex MCP配置中：

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/cursor-mcp-server", "python", "-m", "app.main"]
    }
  }
}

可用工具

get_jira_issue

按密钥获取Jira问题的详细信息。

Input: { "issue_key": "PROJ-123" }
Output: {
  "issue_key": "PROJ-123",
  "summary": "Issue title",
  "description": "Full description...",
  "status": "In Progress",
  "priority": "High",
  "assignee": "John Doe",
  "reproduction_steps": "1. Do this\n2. Do that",
  "comments": [...]
}

get_jira_issue_from_branch

从git分支名称中提取Jira密钥并获取问题详细信息。

Input: { "branch_name": "feature/PROJ-123-add-feature" }
Output: { ... same as get_jira_issue ... }

get_jira_comments

获取Jira问题的评论。

Input: { "issue_key": "PROJ-123", "max_comments": 5 }
Output: {
  "issue_key": "PROJ-123",
  "comment_count": 5,
  "comments": [
    { "author": "Jane Doe", "body": "Comment text...", "created": "..." }
  ]
}

test_jira_connection

验证Jira API连接。

Input: {}
Output: {
  "status": "success",
  "connected_as": "John Doe",
  "email": "john@company.com"
}

发展

本地运行（用于测试）

uv run python -m app.main

运行测试

uv run pytest

项目结构

cursor-mcp-server/
├── app/
│   ├── __init__.py
│   ├── main.py          # MCP server and tool definitions
│   ├── jira_client.py   # Jira API client with caching
│   └── utils.py         # Utility functions
├── pyproject.toml       # Project configuration and dependencies
├── .env                 # Environment variables (not in git)
└── README.md

相关 MCP