AI Tools — Maquina

MCP servers, Claude Code plugins, and AI integrations that connect LLMs to your Rails development workflow. Analyze code, access documentation, and coordinate changes across tools.

Available Tools

MCP Servers

Claude Code Plugins

What is MCP?

The Model Context Protocol (MCP) is a standardized way for AI models to interact with their environment. It defines how models request and use tools, access resources, and maintain context.

MCP servers expose tools that AI assistants can call:

# Example: AI assistant analyzes a Rails model
execute_tool(tool_name: "analyze_models", params: { model_name: "User" })

Supported Clients

• Claude Desktop
• Any MCP-compatible client
• Custom integrations via HTTP/SSE mode

What are Claude Code Plugins?

Claude Code plugins extend Claude’s capabilities within your development environment. They can be installed from marketplaces and provide:

• Agents — Specialized AI assistants for specific tasks
• Skills — Knowledge modules that teach Claude project-specific patterns
• Commands — Custom slash commands for workflows

Installing Plugins

# Add the marketplace
/plugin marketplace add maquina-app/rails-claude-code

# Install a plugin
/plugin install rails-simplifier@rails

Getting Started

With MCP Servers

1. Install an MCP Server

gem install rails-mcp-server

2. Configure Your Client

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "railsMcpServer": {
      "command": "rails-mcp-server"
    }
  }
}

3. Start Using Tools

In Claude Desktop, the MCP server tools become available automatically. Ask Claude to:

• “Analyze the User model in my Rails project”
• “Show me the routes for the orders controller”
• “What’s the database schema for the products table?”

With Claude Code Plugins

1. Add the Marketplace

/plugin marketplace add maquina-app/rails-claude-code

2. Install Plugins

/plugin install rails-simplifier@rails
/plugin install rails-upgrade-assistant@rails
/plugin install maquina-ui-standards@rails

3. Use the Agents

> Review recent changes using the rails-simplifier agent
> Upgrade my Rails app to 8.1
> Create a users index view with maquina components

Architecture

MCP Communication

MCP servers communicate via JSON-RPC 2.0:

Plugin Structure

Claude Code plugins follow a standard structure:

plugin-name/
├── agents/           # AI agent definitions
│   └── agent.md
├── skills/           # Knowledge modules
│   └── SKILL.md
├── commands/         # Custom slash commands
│   └── command.md
└── references/       # Documentation
    └── *.md

Tool Reference

Team Installation

For consistent tooling across your team, add to .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "rails": {
      "source": {
        "source": "github",
        "repo": "maquina-app/rails-claude-code"
      }
    }
  },
  "enabledPlugins": [
    "rails-simplifier@rails",
    "rails-upgrade-assistant@rails",
    "maquina-ui-standards@rails"
  ]
}

Commit this file to your repository. Team members get the same plugins automatically.