完善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 | low | medium | high | xhigh,默认值 low |
