Jira工单增强与代码库探索工具

一个用于通过Claude Desktop/Cursor增强Jira工单和探索代码库的服务,支持工单获取、搜索、更新、创建以及代码库搜索和探索。

  • by Pandekh
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Pandekh/refine-mcp

使用说明

完善mcp

MCP服务器,用于通过Claude Desktop/Cursor对Jira票证进行丰富和代码库探索。

工具

工具 说明
get_ticket 按密钥或URL获取Jira票证
search_tickets 使用JQL搜索门票
list_projects 列出可访问的Jira项目
update_ticket 更新票证字段(摘要、描述、标签、故事点)
create_ticket 创建新票证
enrich_ticket 为AI生成的描述+验收标准准备票务数据
search_repos 按名称搜索GitLab/GitHub仓库
explore_repo 克隆一个仓库并使用AI代理进行探索(需要 OPENAI_API_KEY)

设置

1.通过npx(从GitHub)安装

无需安装——添加到MCP配置中,它将在首次运行时构建:

{
  "mcpServers": {
    "refine": {
      "command": "npx",
      "args": ["github:Pandekh/refine-mcp"],
      "env": {
        "JIRA_URL": "https://your-org.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_TOKEN": "your-jira-api-token",

        "GITHUB_TOKEN": "ghp_...",

        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_TOKEN": "glpat_...",

        "OPENAI_API_KEY": "sk-...",
        "CODEX_MODEL": "gpt-4.1",
        "CODEX_REASONING_EFFORT": "low"
      }
    }
  }
}

2.本地运行(dev)

git clone https://github.com/Pandekh/refine-mcp.git
cd refine-mcp
npm install
npm run build

然后在MCP配置中:

{
  "mcpServers": {
    "refine-dev": {
      "command": "node",
      "args": ["/absolute/path/to/refine-mcp/bin/refine-mcp.js"],
      "env": {
        "JIRA_URL": "...",
        "JIRA_EMAIL": "...",
        "JIRA_TOKEN": "..."
      }
    }
  }
}

环境变量

变量 必填 描述
JIRA_URL 是 您的Jira基本URL,例如。 https://org.atlassian.net
JIRA_EMAIL 是 Jira帐户电子邮件
JIRA_TOKEN 是 Jira API令牌(在id.atlassian.com创建)
GITHUB_TOKEN 可选 GitHub个人访问令牌(用于 search_repos / explore_repo)
GITLAB_URL 可选 GitLab实例URL,例如。 https://gitlab.com
GITLAB_TOKEN 可选 GitLab个人访问令牌
OPENAI_API_KEY 可选 必填 explore_repo (使用OpenAI Codex代理)
CODEX_MODEL 可选 Codex模型,默认 gpt-5.1
CODEX_REASONING_EFFORT 可选 minimal