mcpField
M
MCP Servers Ruby Examples

MCP Servers Ruby Examples

Local
github.com/cs3bDeveloper Tools0Updated 82w ago
Repository

About MCP Servers Ruby Examples

A collection of experimental MCP server implementations and utilities in Ruby for developers exploring MCP. It includes filesystem and clipboard operations, plus an installer that generates configuration for several Claude environments.

Key features

  1. 01Read, create, and modify files
  2. 02List directories and traverse trees
  3. 03Delete files and apply patches
  4. 04Manage the system clipboard
  5. 05Install servers for Claude environments

Use cases

  1. 01Run filesystem operations from an MCP client
  2. 02Access the system clipboard through MCP
  3. 03Configure Ruby servers for Claude Desktop

MCP support

The repository contains Ruby MCP server implementations, including filesystem and clipboard operations. Its installer can configure servers for Claude Desktop, Claude Code, and Windsurf.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Servers Ruby Examples

This repository contains a collection of MCP (Machine Control Protocol) server implementations and utilities written in Ruby. It's more a place for experiments with MCP Servers.

Available Tools

Operating System Utilities

  • Filesystem Operations - Handles file system operations including:

    • Reading files
    • Listing directory contents
    • Directory tree traversal
    • File creation and modification
    • File deletion
    • Patch application

  • Clipboard Operations - Manages system clipboard interactions

Installation

The repository provides a Thor-based installer script for setting up MCP servers with different Claude environments.

Prerequisites
bundle install

The media servers require additional dependencies:

  • ffmpeg (for audio transcoding)
  • Whisper (for speech transcription)
  • Ruby >= 3.0
  • fast-mcp gem (1.1.0 or later)
Installing MCP Servers

The mcp_install script provides commands for installing MCP servers for different Claude environments:

# For Claude Desktop
./mcp_install claude_desktop SERVER_PATH [BASE_PATH]

# For Claude Code
./mcp_install claude_code SERVER_PATH [BASE_PATH]

# For Windsurf
./mcp_install windsurf SERVER_PATH [BASE_PATH]

Parameters:

  • SERVER_PATH: Path to the MCP server implementation
  • BASE_PATH: Base directory for the server (defaults to current directory)
Prompt Templates

The media servers use XML-based prompt templates located in media/prompts/:

  • summarize.transcript.xml.erb - For transcript analysis
  • whats.new.assistant.xml.erb - For content comparison (assistant)
  • whats.new.user.xml.erb - For content comparison (user)

Examples:

# Install for Claude Desktop
./mcp_install claude_desktop ./os/clipboard.rb

# Install for Windsurf
./mcp_install windsurf ./os/clipboard.rb

The installer will:

  1. Generate server configuration
  2. Update configuration file if found:
    • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windsurf: ~/.codeium/windsurf/mcp_config.json
    • Claude Code: (configuration path varies)
  3. Display the generated configuration for manual installation if needed

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.