适合谁
- 使用 Ruby 和 Bundler 的项目，需要 AI 代理进行代码检查、依赖管理或脚本执行。
- 需要节约 Token 的 AI 集成场景。
P
36FMRS · D
Pare Ruby 提供结构化 Ruby/Bundler 操作，适合需要可靠、token 高效输出的 AI 代理。它具备 schema 验证和工具过滤功能，但需要 Node.js >=20，且权限和风险需谨慎管理。
Pare Ruby 是一个 MCP 服务器，封装 Ruby 和 Bundler 常用命令（如运行脚本、语法检查、Gem 管理、Bundler 操作），并返回结构化的、经过 schema 验证的 JSON 数据，而非原始终端文本。它属于 Pare 工具集的一部分，旨在为 AI 代理提供可靠、低 token 消耗的 CLI 操作。
工具能力
run
运行 Ruby 脚本，返回结构化结果（如输出、退出码）。
check
检查 Ruby 语法错误。
gem-list
列出已安装的 gems，返回格式化的 gem 列表。
gem-install
安装一个或多个 gems。
gem-outdated
检查过时的 gems。
bundle-install
执行 bundle install，返回安装结果。
bundle-exec
在 Bundler 上下文中执行命令。
bundle-check
检查 Gemfile 依赖是否已安装。
安装接入
通过 npm 安装并配置 MCP。以 Claude Code 为例，在 MCP 配置中添加：
{"mcpServers": {"pare-ruby": {"command": "npx", "args": ["-y", "@paretools/ruby"]}}}其他客户端配置方法见项目的文档。
选型与风险
不适合谁
- 不需要结构化输出的简单 Ruby 脚本执行。
- 需要交互式 Ruby 会话（如 IRB）的场景。
- 使用非 stdio 传输的 MCP 环境。
所需权限
- 执行 Ruby 命令和 Bundler 命令。
- 读取 gem 安装目录、Gemfile 等相关文件。
- 可能创建或修改 gem 相关文件（如 gem 安装时）。
- 网络访问（若需要从远程仓库安装 gem）。
风险与副作用
- 执行任意 Ruby 命令可能带来代码执行风险，若代理使用不当可能导致安全问题。
- gem 安装可能修改系统环境，需谨慎权限。
- 工具输出可能包含敏感信息（如 gem 版本）需注意保护。
- 依赖注入风险：若供应链被污染，安装的 gem 可能不安全。
常见排障
- 检查 Node.js 版本是否满足 >=20。
- 确认 npx 路径正确（Windows 下可能需要 cmd /c npx）。
- 使用 MCP_TIMEOUT 环境变量增加超时时间，避免连接超时。
- 若工具未注册，检查工具过滤环境变量（PARE_TOOLS 或 PARE_RUBY_TOOLS）。
使用场景
AI 代理需要执行 Ruby/Bundler 命令并获取结构化输出，以进行代码分析或自动化任务。
减少 CLI 输出 Token 消耗，提升代理效率。
在 CI/CD 或开发环境中，代理需要可靠地获取 gem 列表、版本、依赖状态等信息。
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
VS Code / Copilot完整支持
Windsurf完整支持
Cline / Roo Code完整支持
OpenAI Codex完整支持
Gemini CLI完整支持
Zed完整支持
Continue.dev完整支持