mcp_stdio_ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fab19f99766156cb36a1a619581b700a34be89ceca3e19edca0288cfc8990302
+  data.tar.gz: 477e27d118fd1e09d0177dd5ffc15e05576708a35175379c76996259e0bf0b85
+SHA512:
+  metadata.gz: e4408b311907e9230e06adaadf9be8538fa5462631c5ff7b5feec212879afc67359095d91e087538efa1d70a6e9724eb60dd9bc51b2a38433ff8f8d09be3c520
+  data.tar.gz: 849ed98678d2d398bd7e4d18ea394be0c33c7363e265aa67ace6aa7900f44858ed544d9f18dcfaa457c0b3c3a458bdb4db069179ab6c6a1266d5f7aa7ed5f04c

data/.gemini/settings.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "hello-stdio-ruby": {
+      "command": "ruby",
+      "args": [
+        "$HOME/gemini-cli-codeassist/mcp-stdio-ruby/main.rb"
+      ]
+    }
+  }
+}

data/.gitignore

@@ -0,0 +1,29 @@
+# Ruby
+*.gem
+*.rbc
+/.bundle/
+/vendor/bundle/
+/spec/reports/
+/spec/examples.txt
+.rspec_status
+/coverage/
+/tmp/
+*.log
+/doc/
+/.yardoc/
+
+# Environment
+.env
+.env*.local
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDEs
+.idea/
+.vscode/
+*.iml
+.project
+.target
+.settings/

data/.rubocop.yml

@@ -0,0 +1,11 @@
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  TargetRubyVersion: 3.1 # Assuming a reasonably modern Ruby version
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: single_quotes
+
+Layout/LineLength:
+  Max: 120

data/.ruby-version

@@ -0,0 +1 @@
+3.4.8

data/GEMINI.md

@@ -0,0 +1,55 @@
+# Gemini Code Assistant Context
+
+This document provides context for the Gemini Code Assistant to understand the project and assist in development.
+
+## Project Overview
+
+This is a **Ruby based Model Context Protocol (MCP) server**. It is designed to expose tools (like `greet`) over standard input/output (stdio) for integration with MCP clients (such as Claude Desktop or Gemini clients).
+
+## Key Technologies
+
+*   **Language:** Ruby
+*   **SDK:** `mcp` (Model Context Protocol SDK)
+    https://github.com/modelcontextprotocol/ruby-sdk
+
+## Project Structure
+
+*   `main.rb`: Main entry point (Ruby).
+*   `lib/`: Application source code and tools.
+    *   `greet_tool.rb`: Example tool implementation.
+    *   `app_logger.rb`: Logging functionality.
+*   `spec/`: RSpec test suite.
+*   `Makefile`: Development shortcuts (test, lint, clean).
+
+## Development Setup
+
+1.  **Install Dependencies:**
+    ```bash
+    bundle install
+    ```
+
+## Testing & Quality
+
+*   **Run Tests:**
+    ```bash
+    bundle exec rspec
+    ```
+*   **Lint Code:**
+    ```bash
+    bundle exec rubocop
+    ```
+
+## Running the Server
+
+The server is configured to run using the `stdio` transport.
+
+```bash
+bundle exec ruby main.rb
+```
+
+*Note: Since this is an MCP server running over stdio, it is typically not run directly by a human but rather spawned by an MCP client.*
+
+## Ruby MCP Developer Resources
+
+*   **MCP Ruby SDK (GitHub):** [https://github.com/modelcontextprotocol/ruby-sdk](https://github.com/modelcontextprotocol/ruby-sdk)
+*   **Model Context Protocol Documentation:** [https://modelcontextprotocol.io/](https://modelcontextprotocol.io/)

data/Gemfile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+ruby '3.4.8'
+
+gem 'logger'
+gem 'mcp'
+
+group :development, :test do
+  gem 'rake'
+  gem 'rspec'
+  gem 'rubocop'
+  gem 'rubocop-rspec'
+end

data/Gemfile.lock

@@ -0,0 +1,81 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.0.1)
+    diff-lcs (1.6.2)
+    json (2.18.0)
+    json-schema (6.1.0)
+      addressable (~> 2.8)
+      bigdecimal (>= 3.1, < 5)
+    json_rpc_handler (0.1.1)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mcp (0.4.0)
+      json-schema (>= 4.1)
+      json_rpc_handler (~> 0.1)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.7.0)
+    public_suffix (7.0.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.82.1)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-rspec (3.8.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.81)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  logger
+  mcp
+  rake
+  rspec
+  rubocop
+  rubocop-rspec
+
+RUBY VERSION
+   ruby 3.4.8p72
+
+BUNDLED WITH
+   2.6.9

data/Makefile

@@ -0,0 +1,64 @@
+# Makefile for mcp-stdio-ruby
+
+.PHONY: all install run build test lint format type-check status pull push clean
+
+all: install test lint
+
+# Target to install dependencies
+install:
+	@echo "Installing dependencies..."
+	@bundle install
+
+# Target to run the application
+run:
+	@echo "Running the application..."
+	@bundle exec ruby main.rb
+
+release:
+	@echo "Running the application..."
+	@bundle exec ruby main.rb
+
+# Target to build the application (placeholder)
+build:
+	@echo "Building the application..."
+	@echo "No build steps defined for this project."
+
+# Target to run tests
+test:
+	@echo "Running tests..."
+	@bundle exec rspec
+
+# Target to lint the code
+lint:
+	@echo "Linting the code..."
+	@bundle exec rubocop
+
+# Target to format the code
+format:
+	@echo "Formatting the code..."
+	@bundle exec rubocop -a
+
+# Target to type-check the code
+type-check:
+	@echo "Type-checking the code..."
+	@echo "Ruby is dynamic; consider using Sorbet or Steep if needed."
+
+# Target to show git status
+status:
+	@echo "Showing git status..."
+	@git status
+
+# Target to pull latest changes from git
+pull:
+	@echo "Pulling latest changes from git..."
+	@git pull
+
+# Target to push changes to git
+push:
+	@echo "Pushing changes to git..."
+	@git push
+
+.PHONY: clean
+clean:
+	@echo "Cleaning up..."
+	@rm -rf vendor .bundle

data/README.md

@@ -0,0 +1,58 @@
+# MCP Stdio Ruby Server
+
+A simple Model Context Protocol (MCP) server implemented in Ruby. This server provides a `greet` tool and uses the `stdio` transport for communication with MCP clients.
+
+## Features
+
+- **greet**: A tool that accepts a message and echoes it back, demonstrating simple tool integration.
+- **Logging**: Integrated application logging for debugging and monitoring.
+
+## Prerequisites
+
+- Ruby 3.0 or higher
+- Bundler
+
+## Setup
+
+1.  **Clone the repository** (if you haven't already).
+2.  **Install Dependencies**:
+    ```bash
+    make install
+    ```
+    or
+    ```bash
+    bundle install
+    ```
+
+## Usage
+
+### Running the Server
+
+To start the server using the stdio transport:
+
+```bash
+make run
+```
+or
+```bash
+bundle exec ruby main.rb
+```
+
+### Integrated Tools
+
+#### `greet`
+- **Arguments**:
+  - `message` (string, required): The message to repeat.
+- **Returns**: A text response containing the input message.
+
+## Development
+
+The project uses `rake` for common development tasks:
+
+- **Run Tests**: `bundle exec rake test`
+- **Lint Code**: `bundle exec rake lint`
+- **Auto-format Code**: `bundle exec rubocop -a`
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'rubocop/rake_task'
+require 'rspec/core/rake_task'
+
+task default: %i[test lint]
+
+desc 'Run RSpec tests'
+RSpec::Core::RakeTask.new(:test) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+desc 'Run RuboCop'
+RuboCop::RakeTask.new(:lint)

data/lib/mcp_stdio_ruby/app_logger.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+module McpStdioRuby
+  # Provides a centralized logger for the application.
+  module AppLogger
+    class << self
+      def logger
+        @logger ||= Logger.new($stderr).tap do |l|
+          l.level = Logger::INFO
+        end
+      end
+
+      attr_writer :logger
+    end
+  end
+end

data/lib/mcp_stdio_ruby/greet_tool.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'mcp'
+require_relative 'app_logger'
+
+module McpStdioRuby
+  # Define the greet tool
+  class GreetTool < MCP::Tool
+    tool_name 'greet'
+    description 'Gives a friendly greeting.'
+    input_schema(
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'The name to greet.'
+        }
+      },
+      required: ['name']
+    )
+
+    class << self
+      def call(name:)
+        AppLogger.logger.info "GreetTool called with name: #{name}"
+        MCP::Tool::Response.new(
+          [
+            {
+              type: 'text',
+              text: "Hello, #{name}!"
+            }
+          ]
+        )
+      end
+    end
+  end
+end

data/lib/mcp_stdio_ruby/server.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'mcp'
+require_relative 'app_logger'
+require_relative 'greet_tool'
+
+module McpStdioRuby
+  # Encapsulates the MCP Server logic
+  class Server
+    attr_reader :server
+
+    def initialize
+      @server = MCP::Server.new(
+        name: 'hello-world-server',
+        version: '1.0.0',
+        tools: [GreetTool]
+      )
+    end
+
+    def start
+      AppLogger.logger.info "Starting MCP server: #{server.name} (v#{server.version})"
+      run_transport
+    rescue Interrupt
+      AppLogger.logger.info 'Shutting down MCP server...'
+    rescue StandardError => e
+      handle_error(e)
+    end
+
+    private
+
+    def run_transport
+      MCP::Server::Transports::StdioTransport.new(server).open
+    end
+
+    def handle_error(err)
+      AppLogger.logger.error "Server error: #{err.message}"
+      AppLogger.logger.error err.backtrace.join("\n")
+      exit 1
+    end
+  end
+end

data/lib/mcp_stdio_ruby.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative 'mcp_stdio_ruby/app_logger'
+require_relative 'mcp_stdio_ruby/greet_tool'
+require_relative 'mcp_stdio_ruby/server'
+
+# Main module for the MCP Stdio Ruby application
+module McpStdioRuby
+end

data/main.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative 'lib/mcp_stdio_ruby'
+
+# Run the server using stdio transport
+McpStdioRuby::Server.new.start if __FILE__ == $PROGRAM_NAME

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: mcp_stdio_ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Code Assistant
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A Ruby implementation of a Model Context Protocol (MCP) server using
+  stdio transport.
+email:
+- example@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gemini/settings.json"
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-version"
+- GEMINI.md
+- Gemfile
+- Gemfile.lock
+- Makefile
+- README.md
+- Rakefile
+- lib/mcp_stdio_ruby.rb
+- lib/mcp_stdio_ruby/app_logger.rb
+- lib/mcp_stdio_ruby/greet_tool.rb
+- lib/mcp_stdio_ruby/server.rb
+- main.rb
+homepage: https://github.com/example/mcp_stdio_ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/example/mcp_stdio_ruby
+  source_code_uri: https://github.com/example/mcp_stdio_ruby
+  changelog_uri: https://github.com/example/mcp_stdio_ruby/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A Ruby based Model Context Protocol (MCP) server.
+test_files: []