使用说明
完善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 |