Rails MCP 服务器

简介

Rails MCP 服务器是一个专为与支持 Model Context Protocol (MCP) 的大语言模型 (LLM) 客户端集成而设计的工具。它允许通过一系列预定义的工具对 Rails 项目进行分析和操作，从而增强开发效率。

安装与配置

安装依赖

1. 克隆仓库：

   git clone https://github.com/maquina-app/rails-mcp-server.git
   cd rails-mcp-server
   

2. 使用 Bundler 安装依赖项：

   bundle install
   

启动服务器

1. 根据需要选择模式启动：

   • 标准输入输出 (STDIO) 模式（默认）：

     bin/rails-mcp-server
     

   • HTTP 模式：

     bin/rails-mcp-server --mode http
     

使用指南

标准工具调用

所有工具均通过 MCP 协议的 tool_calls 方法执行，具体如下：

1. 项目分析

# 分析整个 Rails 项目
tool_calls :analyze_rails_project, project_path: "."

# 列出所有可用工具
tool_calls :list_tools

2. 数据库 Schema 分析

# 获取完整的数据库模式
tool_calls :get_schema

# 获取特定表的详细信息
tool_calls :get_schema, table_name: "users"

高级功能

环境配置分析

# 分析环境配置文件
tool_calls :analyze_environment_config

与 LLM 客户端集成

要使用支持 MCP 协议的客户端（如 Claude Desktop），请按照以下步骤操作：

1. 启动 Rails MCP 服务器。
2. 将客户端连接到服务器。
3. 使用可用工具进行项目分析。

测试与调试

使用 MCP 检查器

MCP 检查器是一个专为测试和调试设计的开发者工具。使用步骤如下：

1. 安装检查器：

   npm install -g @modelcontextprotocol/inspector
   

2. 启动检查器并连接 Rails MCP 服务器：

   npx @modelcontextprotocol/inspector /path/to/rails-mcp-server
   

3. 在浏览器中访问默认地址（http://localhost:6274），开始交互式调用和调试。

许可证

Rails MCP 服务器遵循 MIT 许可证。查看 LICENSE 文件获取详细信息。

贡献指南

欢迎贡献！请参考 CONTRIBUTING.md 获取参与方式。

目录

• 简介
• 安装与配置
  • 安装依赖
  • 启动服务器
• 使用指南
  • 标准工具调用
  • 高级功能
• 集成与 LLM 客户端
• 测试与调试
  • 使用 MCP 检查器
• 许可证
• 贡献指南