GitLab问题分析器
MCP(模型上下文协议)服务器,从特定项目中获取GitLab问题,并将分析文档保存到Notion。
特性
- 获取GitLab问题:检索详细的问题信息,包括讨论和评论,获取问题的概述、摘要和解释,以及如何解决问题的建议。通过避免长时间阅读节省时间,无需复制和粘贴上下文。直接在人工智能助手的帮助下制定解决方案。
- 列出未决问题:从项目中获取所有未解决的问题,使AI助手意识到并能够处理任何问题。
- 保存到Notion:创建带有问题分析、摘要和解决方案步骤的格式化Notion页面,这些页面可以在创建Jira票证时重复使用。
可用工具
fetch_gitlab_issue
获取特定GitLab问题的完整细节。
- 参数:
issue_number(int)-问题IID(例如,问题#40为40)或简单地按标题描述问题,AI助手可以识别 - 退货:问题详细信息,包括标题、描述、讨论、受让人和标签
list_open_gitlab_issues
列出ACM GitLab项目的所有未解决问题。
- 退货:一系列包含基本信息的未决问题
save_issue_analysis_to_notion
使用格式化的部分将问题分析保存到Notion。
- 参数:
- issue_number (int) - issue_title (str) - summary (str) - suggestions (str) - solution_steps (str) - issue_url (str,可选)
设置
- 安装uv (如果尚未安装):
curl -LsSf https://astral.sh/uv/install.sh | sh- 克隆和安装依赖项:
使用紫外线:
cd gitLab-issue-analyzer
uv sync这将自动安装来自的所有依赖项 pyproject.toml.
- 创建
.env文件 具有所需凭据:
GITLAB_TOKEN=your_gitlab_token
GITLAB_PROJECT_PATH=eclipse-research-labs/codeco-project/acm
NOTION_API_KEY=your_notion_integration_key
NOTION_PAGE_ID=your_notion_parent_page_id- 在Cursor/Claude中配置:
添加到MCP设置中:
使用uv(建议更快启动):
{
"mcpServers": {
"gitlab-issue-analyzer": {
"command": "uv",
"args": ["run", "--directory", "/path/to/gitLab-issue-analyzer", "main.py"]
}
}
}示例用法
配置为MCP服务器后,您可以通过Claude Desktop或Cursor AI使用它:
# Fetch a specific issue:
"fetch_gitlab_issue 40" or "Fetch and analyze GitLab issue 40"
# List all open issues:
"List all open GitLab issues"
# Save analysis to Notion:
"Save analysis and solutions discussed above to Notion"文件
main.py-主MCP服务器实现gitlab_integration.py-GitLab API集成函数pyproject.toml-Python项目依赖关系(用于uv).env-环境变量(未在git中跟踪)
认证
- GitLab:需要个人访问令牌
read_api范围 - 概念:需要集成令牌和创建新页面的父页面ID
