MCP.so
Sign In

Action MCP Example

@seuros

Basic information

Category

Developer Tools

Transports

stdio

Author

seuros

About Action MCP Example

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

Action MCP Example 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"
      ]
    }
  }
}

Action MCP Example tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Frequently asked questions

1

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](https://github.com/seuros/mcp).

2

How does authentication work?

JWT tokens are used. Test users (e.g., `test@example.com` / `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.

3

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.

4

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`.

5

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.

Comments

More Developer Tools MCP servers