Action MCP Example 🚀

Name: Action MCP Example 🚀
Author: seuros

@seuros

About Action MCP Example 🚀

A minimal Rails API template for creating MCP (Model Context Protocol) servers with robust tool execution capabilities and examples.

#agents #rails-api #claude #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_rails_template": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "--url",
        "http://localhost:8080/mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Action MCP Example 🚀?

A simple Ruby on Rails application demonstrating how to integrate and use the ActionMCP gem. It is intended for developers who want to see how to define MCP components (prompts, resource templates, tools) within a Rails project.

How to use Action MCP Example 🚀?

Clone the repository, run bin/setup, copy .env.example to .env and fill in required values (e.g., API keys). Set up PostgreSQL (e.g., via make up for Docker on port 5466), then start the Rails server with bin/rails s. The ActionMCP server runs on port 62770, proxied by Nginx at /mcp. You can test interactively using the MCP Inspector: npx @modelcontextprotocol/inspector --url http://localhost:8080/mcp.

Key features of Action MCP Example 🚀

JWT‑based authentication with predefined test users
Adventure story prompt generator
Gemfile dependency resource template (JSON over gemfile://{environment})
Weather forecast tool via Open‑Meteo API
RuboCop style analysis tool for Ruby snippets
Dependency info tool (production, test, runtime)
Ruby code static analysis tool (classes, modules, methods)

Use cases of Action MCP Example 🚀

Generate a short narrative adventure story from a hero name and genre
Fetch weather data for given latitude/longitude coordinates
Analyze a Ruby code snippet for style offenses using RuboCop
Retrieve project dependencies (Gemfile) as structured JSON
Index and query Ruby source files for classes, modules, and methods

FAQ from Action MCP Example 🚀

What are the runtime requirements?

Ruby (see .ruby-version) and PostgreSQL (or Docker for a temporary instance). The ActionMCP gem is sourced from https://github.com/seuros/mcp.

How does authentication work?

JWT tokens are used. Test users (e.g., [email protected] / password123) are loaded from fixtures. Tokens can be generated in the Rails console. A pre‑configured .mcp.json file with a long‑lived token is provided.

Where does the MCP server run?

The ActionMCP server runs as a standalone server on port 62770 (via mcp.ru). Nginx proxies /mcp requests to this server.

What MCP components are included?

Prompts: epic_adventure_prompt.rb. Resource Templates: gemfile_template.rb. Tools: dependency_info_tool.rb, fetch_weather_by_location_tool.rb, rubocop_tool.rb, ruby_code_analyzer_tool.rb.

How can I test the MCP server interactively?

Use the MCP Inspector: npx @modelcontextprotocol/inspector --url http://localhost:8080/mcp. Make sure Docker is running (docker compose up) before executing the inspector command.