ruby-mcp-server-generator Skill for Claude Code: What It Does and How to Install It

Makes Claude generate a complete Ruby MCP server project with the official Ruby SDK, with tests and a README.

Installs: 8.6K; on skills.sh
Stars: 40.7K; on GitHub
Updated: Oct 2026; last repo commit

Ask Claude for a Ruby MCP server. It asks for a project name and description, then writes the whole project: a Gemfile and Rakefile, a server class, two sample tools (greet and calculate), a code_review prompt, an example resource, a stdio start script, tests and a README. The Gemfile template uses the mcp gem pinned to ~> 0.4.0, with minitest, rake and rubocop for development.

The SKILL.md is a set of file templates plus ten generation rules, such as input and output schemas, tool annotations, structured content and error handling with the is_error flag. The README it generates says the project needs Ruby 3.0 or later and shows a Rails controller example and a Claude Desktop config.

Good for

Ruby developers who want to expose their code as MCP tools
Rails teams that want to serve MCP requests from a controller
Builders who want a minitest test for every tool

Install ruby-mcp-server-generator

Claude Code

Copy this prompt.

Install the ruby-mcp-server-generator skill in Claude Code. Run this command:

npx skills add https://github.com/github/awesome-copilot --skill ruby-mcp-server-generator

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Pick one route. The ruby-mcp-development Copilot CLI plugin holds this skill and the ruby-mcp-expert agent (1 skill, 1 agent in plugin.json). The skills CLI and folder routes install only the skill. The skill's README template needs Ruby 3.0 or later, so there is no Claude app upload route. The plugin folder on the main branch holds plugin.json and a README only, so check what the install adds.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Generate a complete Model Context Protocol server project in Ruby using the official MCP Ruby SDK gem.

Sections in SKILL.md

Project Generation
Gemfile Template
Rakefile Template
lib/my_mcp_server.rb Template
lib/my_mcp_server/server.rb Template
lib/my_mcp_server/tools/greet_tool.rb Template
lib/my_mcp_server/tools/calculate_tool.rb Template
lib/my_mcp_server/prompts/code_review_prompt.rb Template
lib/my_mcp_server/resources/example_resource.rb Template
bin/mcp-server Template
test/test_helper.rb Template
test/tools/greet_tool_test.rb Template
test/tools/calculate_tool_test.rb Template
README.md Template
Features
Requirements

Key facts

Author: Awesome Copilot Community (author listed in the plugin.json that includes it)
License: MIT (LICENSE: Copyright GitHub, Inc.)
Installs on skills.sh: 8,606 (Nov 2, 2026)
GitHub stars: 40,666 for the whole github/awesome-copilot repo (Nov 2, 2026)
Last repo commit: Oct 30, 2026
What it includes: 1 file: SKILL.md. It bundles no scripts
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass (Nov 2, 2026)
Needs: Ruby 3.0 or later for the generated project (from the README template in SKILL.md)

What it includes

First step of the generation rules
Claude asks for a name and description before it writes anything.
Ask for project name and description
Pins the mcp gem to ~> 0.4.0 and adds test and rubocop tasks
Development group has minitest ~> 5.0, rake ~> 13.0 and rubocop ~> 1.50.
Write · Gemfile and Rakefile
lib/my_mcp_server/server.rb wires tools, prompts and resources
Includes a handle_json method and a stdio start method.
Write · Server class
Typed input and output schemas, annotations and structured content
The calculate tool covers add, subtract, multiply and divide and returns an error on division by zero.
Try: “Create a Ruby MCP server for my project”
Write · Sample tools: greet and calculate
One MCP prompt and one JSON resource
The prompt takes a language and an optional focus. The resource is served at resource://data/example.
Write · Code review prompt and example resource
Starts the server over stdio
SKILL.md tells Claude to make it executable with chmod +x bin/mcp-server.
Runs code · bin/mcp-server
A test file for each sample tool plus a test helper
The Rakefile runs them with rake test, and rubocop with rake rubocop.
Write · Minitest tests
Documents bundle install, stdio use and a Rails controller
The Claude Desktop entry runs bundle exec bin/mcp-server with a cwd path you fill in.
Write · README with Rails and Claude Desktop examples

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

You install gems from the Gemfile
The generated Gemfile lists mcp, minitest, rake and rubocop from rubygems.org. Read it before you run bundle install. github.com
The Copilot CLI plugin adds an agent
The ruby-mcp-development plugin adds the ruby-mcp-expert agent next to the skill. Its front matter lists a name, description and model, and no tools. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Use version control.
Sign-in and keys	SKILL.md does not mention any account or key.
Scopes	Writes 13 new project files, including a Gemfile, tests and a README Runs chmod +x on bin/mcp-server

Questions

What does the ruby-mcp-server-generator skill do?

It makes your agent write a complete Ruby MCP server project using the official MCP Ruby SDK gem. The project has sample tools, a prompt, a resource, tests and a README.

How do I install it in Claude Code?

Use the install box at the top of this page. The skills CLI route installs this skill alone. A Copilot CLI plugin, ruby-mcp-development, also holds it together with a ruby-mcp-expert agent.

What do I need to run the generated server?

The README template in SKILL.md says Ruby 3.0 or later, and shows bundle install to fetch the gems. The Gemfile pins the mcp gem to ~> 0.4.0.

How do I connect the generated server to Claude Desktop?

The generated README includes a claude_desktop_config.json entry. It runs bundle with the arguments exec bin/mcp-server and a cwd you set to the project folder.

Does it work in the Claude app?

There is no Claude app upload route here, because the generated project needs Ruby on your machine. The install box lists Claude Code, Codex and Copilot CLI routes.

Is it safe?

It writes new files into your project folder and runs chmod +x on bin/mcp-server. The Gemfile it writes pulls gems from rubygems.org when you run bundle install. Our advice: create the project in an empty folder and read the Gemfile before you install.

Information

updated Nov 2, 2026

Repository: github/awesome-copilot
Folder: skills/ruby-mcp-server-generator

github/awesome-copilot skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

ruby-mcp-server-generator SKILL.md · github.com
awesome-copilot README · github.com
ruby-mcp-development plugin.json · github.com
ruby-mcp-development README · github.com