ProTools MCP Server
Provides tools for working with Git repositories, including detecting changes and reviewing staged/unstaged diffs.
Provides AI-powered code review and document generation using Google Gemini models.
Provides AI-powered code review and document generation using OpenAI models.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ProTools MCP Server review staged changes with OpenAI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ProTools MCP Server
可扩展的 MCP 工具盒,封装日常开发脚本。支持代码合并、AI 代码审查等功能。
功能特性
代码合并:将多个源文件合并为单一上下文,支持压缩模式
AI 代码审查:支持 OpenAI GPT-5.2 和 Google Gemini 3 Flash 双模型并发审查
文档生成:从代码/配置变更中提取隐含规范,生成技术规范、设计决策、变更日志
异步任务:长时间任务支持异步执行和轮询查询
智能默认:未指定审查目标时自动检测 Git 变更
Related MCP server: code-lens
工具列表
protools_merge_files
合并多个源代码文件,供对话模型作为上下文使用。
参数 | 类型 | 默认值 | 说明 |
|
| 必填 | 文件/目录/glob 路径列表 |
|
|
| 压缩模式 |
|
| - | 过滤扩展名,如 |
|
| - | 排除的 glob 模式 |
|
|
| 按输入路径分组输出 |
|
|
| 输出方式 |
|
|
| 输出目录 |
|
| - | 超过此字节数强制落盘 |
压缩模式:
full:保留全部内容compact:移除注释和 importskeleton:仅保留签名
protools_code_review
使用 AI 对代码进行同步审查。
参数 | 类型 | 默认值 | 说明 |
|
| - | 工作目录(多仓库工作区时指定项目路径) |
|
| - | 文件/目录/glob 路径(与 git_mode 二选一) |
|
| - | Git diff 模式(未指定 inputs 时自动启用) |
|
|
| Git 模式下是否包含完整文件内容 |
|
|
| 是否包含项目上下文 |
|
|
| 审查关注领域 |
|
| - | 指定单个 Provider |
|
|
| 代码压缩模式 |
|
| - | 附加审查说明 |
|
|
| 输出方式 |
protools_code_review_start
启动异步代码审查任务,返回任务 ID。
参数 | 类型 | 默认值 | 说明 |
继承 | |||
|
| - | 并发使用的 Provider 列表 |
|
|
| 等待首个结果的超时时间(毫秒) |
提示:未指定
inputs和git_mode时,会自动检测 Git 变更并使用all模式。
protools_code_review_status
查询异步代码审查任务状态。
参数 | 类型 | 说明 |
|
| 任务 ID |
protools_document_suggest
从代码/配置变更中提取隐含规范,生成结构化文档。
参数 | 类型 | 默认值 | 说明 |
|
| - | 工作目录 |
|
| - | 文件/目录/glob 路径(与 git_mode 二选一) |
|
| - | Git diff 模式 |
|
|
| 文档类型 |
|
|
| 输出格式 |
|
|
| 输出语言 |
|
| - | 附加背景说明 |
|
|
| LLM Provider |
|
| - | 过滤扩展名 |
|
| - | 排除的 glob 模式 |
文档类型:
spec:技术规范(配置格式、字段定义、约束规则)decision:设计决策(技术选型、架构权衡)changelog:变更日志(按类别分组的变更记录)auto:自动推断最合适的类型
输出格式:
feishu(默认):针对飞书优化,避免 HTML,标题不超 3 级markdown:标准 Markdown
环境变量配置
# OpenAI 配置
OPENAI_API_KEY=sk-xxx # OpenAI API Key
OPENAI_BASE_URL= # 可选,自定义 API 地址
OPENAI_REASONING_EFFORT=medium # 推理级别:none | low | medium | high | xhigh
# Gemini 配置
GEMINI_API_KEY=xxx # Google AI API Key
GEMINI_THINKING_LEVEL=HIGH # 思考级别:NONE | LOW | MEDIUM | HIGH
# Provider 配置
LLM_PROVIDER=openai,gemini # 默认使用的 Provider(逗号分隔)
CONCURRENT_REVIEW=true # 是否启用并发审查
ASK_USER_FEEDBACK=false # 是否询问用户反馈MCP 配置示例
Claude Desktop / Cursor
{
"mcpServers": {
"protools": {
"command": "node",
"args": ["/path/to/ProTools/dist/index.js"],
"env": {
"OPENAI_API_KEY": "sk-xxx",
"OPENAI_REASONING_EFFORT": "medium",
"GEMINI_API_KEY": "xxx",
"LLM_PROVIDER": "openai,gemini",
"CONCURRENT_REVIEW": "true",
"GEMINI_THINKING_LEVEL": "HIGH"
}
}
}
}开发模式(使用 tsx)
{
"mcpServers": {
"protools": {
"command": "npx",
"args": ["tsx", "/path/to/ProTools/src/index.ts"],
"env": {
"OPENAI_API_KEY": "sk-xxx",
"OPENAI_REASONING_EFFORT": "medium",
"GEMINI_API_KEY": "xxx",
"LLM_PROVIDER": "openai,gemini",
"CONCURRENT_REVIEW": "true"
}
}
}
}开发
# 安装依赖
npm install
# 开发运行
npm run dev
# 编译
npm run build
# 类型检查
npx tsc --noEmit项目结构
src/
├── index.ts # MCP Server 入口
├── core/
│ ├── io.ts # 文件 IO 工具
│ ├── merge.ts # 代码合并逻辑
│ ├── git.ts # Git 操作
│ ├── project-context.ts # 项目上下文收集
│ └── llm/ # LLM Provider
│ ├── index.ts
│ ├── base-provider.ts
│ ├── openai-provider.ts
│ └── gemini-provider.ts
├── tools/
│ ├── merge-files.ts # 合并文件工具
│ ├── code-review.ts # 代码审查工具
│ ├── document-suggest.ts # 文档生成工具
│ └── review/ # 审查子模块
│ ├── task-store.ts # 任务存储
│ ├── report-generator.ts
│ └── result-processor.ts
├── prompts/
│ ├── review-prompt.ts # 审查 Prompt 构建器
│ ├── document-prompt.ts # 文档 Prompt 构建器
│ └── templates/ # Prompt 模板
│ ├── review.ts
│ └── document.ts
└── types/
├── merge.ts
├── review.ts
└── document.tsLicense
MIT
Available Tools
5 toolsprotools_code_reviewB
使用 AI 对代码进行审查,支持安全性、性能、质量和可维护性分析。支持 OpenAI GPT-5.2 和 Google Gemini 3 Flash。
Inputs: cwd, mode, focus, inputs, +9 more.
protools_code_review_startA
启动异步代码审查任务,返回任务 ID 并支持查询进度或获取部分结果。
重要:审查结果需要批判性分析
不是所有报告的问题都需要修复,需根据项目实际情况判断
区分真正的问题 vs 过度工程化建议(如"建议添加更多配置")
INFO 级别通常可忽略,MINOR 需权衡成本,MAJOR/CRITICAL 才是重点
如果多个模型报告相同问题,可信度更高
高效等待(避免轮询)
设置较大的 wait_first_result_ms(如 60000)一次性等待首个结果
或在查询 status 前用 Bash sleep 间隔等待(如 sleep 15)
不要疯狂轮询 status,每次调用都消耗 token
Inputs: cwd, mode, focus, inputs, +11 more.
protools_code_review_statusA
查询异步代码审查任务状态,可获取部分或最终结果。
注意:审查结果需批判性分析,详见 protools_code_review_start 的说明。
Inputs: task_id (required).
protools_document_suggestA
从代码/配置变更中提取隐含规范,生成结构化文档。
文档类型
spec: 技术规范(配置格式、字段定义、约束规则)
decision: 设计决策(为什么这么做、权衡考量)
changelog: 变更日志(按类别分组的变更记录)
auto: 自动推断最合适的类型
输出格式
markdown: 标准 Markdown
feishu: 飞书优化格式(默认,避免 HTML、标题不超 3 级)
使用示例
从 Git 变更生成技术规范:git_mode="staged", doc_type="spec"
从文件生成设计决策:inputs=["src/**/*.yml"], doc_type="decision"
Inputs: cwd, format, inputs, context, +6 more.
protools_merge_filesA
合并多个源代码文件,供对话模型作为上下文使用。支持压缩模式(full/compact/skeleton)、扩展名过滤、排除规则、分组输出。
Inputs: inputs (required), mode, group, output, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct purpose: synchronous code review, async code review initiation, status query, document generation, and file merging. No overlapping functionality, and descriptions clearly differentiate them.
All tools share a common prefix 'protools_', but the verb/noun order varies: 'code_review' (noun), 'code_review_start' (noun+verb), 'document_suggest' (noun+verb), 'merge_files' (verb+noun). This mixed pattern reduces predictability.
Five tools is a well-scoped set for a server focused on code review and documentation. No unnecessary redundancy or excessive operations.
The tool set covers core workflows: sync/async review, status tracking, documentation generation, and file merging. Missing features like review list or cancellation are minor and don't hinder common use cases.
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
1Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityDmaintenanceAnalyzes GitHub repositories using Gemini AI and generates comprehensive documentation including overviews, architecture guides, and file insights. Works with any MCP-compatible client.320 PyPIMIT
- AlicenseAqualityDmaintenanceGemini-powered MCP server for automated code review, analysis, and documentation.13142 npmMIT
- AlicenseAqualityDmaintenanceProvides MCP tools to review git changes using OpenAI Codex CLI, enabling code review of unstaged, staged, or last-commit changes.316 npmMIT
- AlicenseNot gradedqualityDmaintenanceSmart documentation generator and intelligent versioning system with full MCP support, enabling AI assistants like Claude and Gemini to manage project snapshots, generate docs, and control versioning via 26 MCP tools.40 PyPI1MIT