MCP Servers Ruby

This project is an experimental toolset for MCP servers implemented in Ruby, including operating system tools and media server functions, providing functions such as file operations, clipboard management, and speech transcription.

Developer tools Operating system automation #Ruby tools #File operations #Clipboard #Speech transcription .ruby

rating : 2 points

downloads : 5.1K

update time : 2025-04-28

Open Site

What is the MCP Servers Ruby toolset?

This is a collection of Ruby tools for exploring the development of Machine Control Protocol (MCP) servers. It mainly includes practical function modules at the operating system level to help developers quickly build and test MCP server applications.

How to use these tools?

It can be configured for use in different Claude environments through a simple command-line installation script, supporting common functions such as file operations and clipboard management.

Applicable scenarios

Suitable for developers who need to deeply integrate with Claude series products (Desktop/Code/Windsurf), or users who need to build automated workflows.

Main features

File system operations

Provides complete file system interaction capabilities, including file read and write, directory traversal, file modification and deletion operations.

Clipboard integration

Implements the read and write functions of the system clipboard, supporting cross-application data exchange.

Media processing support

Integrates ffmpeg and Whisper, providing audio transcoding and speech transcription capabilities.

Advantages

One-click installation and configuration, supporting multiple Claude environments

Provides commonly used system-level operation APIs

Modular design, allowing each functional component to be used independently

Built-in intelligent prompt templates to optimize the AI interaction experience

Limitations

Currently mainly optimized for the macOS system

Requires a Ruby 3.0+ runtime environment

Media functions require additional installation of dependencies such as ffmpeg

How to use

Install dependencies

Ensure that Ruby 3.0+ and Bundler are installed on the system, and then run the dependency installation command.

Select the installation target

Select the corresponding installation command according to the Claude environment you are using.

Verify the installation

Check whether the MCP server configuration has been updated in the configuration directory of the target application.

Usage examples

Automated file processing

Automatically organize files in the download directory through the file system operation module.

Clipboard content analysis

Capture the clipboard content and send it to the AI for analysis and processing.

Frequently Asked Questions

What should I do if there is a dependency error during installation?

How can I confirm whether the installation is successful?

The media function is not working properly?

Related resources

Ruby official website

Get the latest version and documentation of the Ruby programming language.

ffmpeg documentation

The official documentation of the multimedia processing tool ffmpeg.

Whisper project

An open-source speech recognition system by OpenAI.

🚀 MCP Server Ruby Example

This repository contains a set of server implementations and utilities based on the Machine Control Protocol (MCP), primarily written in Ruby. It serves more as an experimental ground to explore the various possibilities of MCP servers.

🚀 Quick Start

This repository offers a Thor-based installation script for configuring MCP servers in different Claude environments.

✨ Features

Operating System Utilities

Filesystem Operations - Handles filesystem 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

Prerequisites

bundle install

The media server requires additional dependencies:

ffmpeg (for audio transcoding)
Whisper (for speech transcription)
Ruby >= 3.0
fast-mcp gem (version 1.1.0 or higher)

Installing the MCP Server

The mcp_install script provides the following commands to install 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: The path to the MCP server implementation
BASE_PATH: The base directory of the server (default is the current directory)

Prompt Templates

The media server uses XML-based erb 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)

Example:

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

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

The installer will perform the following actions:

Generate server configuration
Update the configuration file if an existing one is found:
- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windsurf: ~/.codeium/windsurf/mcp_config.json
- Claude Code: (The specific path varies by environment)
Display the generated configuration for manual installation if needed