rails-diff-mcp

🚀 Rails Diff MCP 服务器

Rails Diff MCP 服务器将 Rails 版本差异作为工具对外提供。数据来源于 railsdiff/rails-new-output GitHub 仓库，该仓库中每个 Rails 版本都标记了 rails new 的输出结果。

🚀 快速开始

准备工作

• 安装 Docker 和 Docker Compose
• 可选：设置 GITHUB_TOKEN 环境变量，以避免 GitHub API 速率限制

启动服务器

docker compose up -d

服务器监听地址为 http://localhost:8080/mcp，健康检查地址为 http://localhost:8080/healthz。

在 MCP 客户端中注册

以 Claude Code 为例：

claude mcp add --transport http rails-diff http://localhost:8080/mcp

重启 MCP 客户端以加载新服务器。

✨ 主要特性

| 工具 | 描述 | |------|-------------| | list_rails_versions | 列出所有可用的 Rails 版本（已排序） | | compare_rails_versions | 比较两个版本 — 返回变更文件列表 | | get_file_diff | 获取两个版本之间特定文件的补丁 |

📦 安装指南

开发环境

bun install
bun src/index.ts

服务器默认在 8080 端口启动。可通过 PORT 环境变量进行覆盖。

📚 详细文档

配置说明

| 环境变量 | 描述 | 默认值 | |---------|-------------|---------| | PORT | 服务器监听端口 | 8080 | | GITHUB_TOKEN | GitHub 个人访问令牌（提高 API 速率限制） | 无 |

📄 许可证

文档未提及相关许可证信息。

🔗 致谢

本项目基于 RailsDiff 构建，由 Andy Stewart 及贡献者开发。差异数据来源于 railsdiff/rails-new-output。