mcp-rb 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 28e6b1fc53252ecd7717e71d06f0c124c61a8fbb9e389fa9514f3249b056930e
-  data.tar.gz: 454af20d33b8cbe80dad61214b0ca3680a8715bef024d4d26dd77a5b800e37ba
+  metadata.gz: 131c29522f8eb44f7f613f51d92db433370d99950dcfcd27340ab9917b306dd3
+  data.tar.gz: a676110b09851f7018205bc012b09a6f22d1c7730555ba569b9b7ae475c06009
 SHA512:
-  metadata.gz: 6aca66d612f5851304248561e0eb73402ef30d30da6fd45c35aea89b43d6499c29da58a37f6deae55931a3ede9eb56de4cf447595adaee8f227836e8923f1823
-  data.tar.gz: cde9c8f9b18b6945d5e5e478ea18e1592c372393b1263f329b35bc0510df58110feda73ae1fcd785d93af0e701fe6bfaab200296845d7b601ba33525337f654c
+  metadata.gz: ebe914ec0fa9ba0ef97650f83454d0fe5bf5c924717365d5cea3bdd73bfb06b5e0ede7d49c6da2caa8d38c5a337bae3c98c22b86d5f1c25740785c66ac195509
+  data.tar.gz: 719f1f95950ca24c0695316af978866e1b8834b5112c962701324d8279faa9e5705151157d23a66e7f9e6572313df18f7c4acfc247037965d059f12bdcacb883

data/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2025-02-19
+
+- Allow specifying the version via DSL keyword: https://github.com/funwarioisii/mcp-rb/pull/2
+- Add MCP Client: https://github.com/funwarioisii/mcp-rb/pull/3
+
+### Breaking Changes
+- `MCP::PROTOCOL_VERSION` is moved to `MCP::Constants::PROTOCOL_VERSION`
+  - https://github.com/funwarioisii/mcp-rb/pull/3/commits/caad65500935a8eebfe024dbd25de0d16868c44e
+
 ## [0.2.0] - 2025-02-14
 
 ### Breaking Changes

data/README.md

@@ -36,6 +36,23 @@ tool "greet" do
 end
 ```
 
+## Supported specifications
+
+Reference: [MCP 2024-11-05](https://spec.modelcontextprotocol.io/specification/2024-11-05/)
+
+- [Base Protocol](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/)
+  - ping
+  - stdio transport
+- [Server features](https://spec.modelcontextprotocol.io/specification/2024-11-05/server/)
+  - Resources
+    - resources/read
+    - resources/list
+  - Tools
+    - tools/list
+    - tools/call
+
+Any capabilities are not supported yet.
+
 ## Testing
 
 ```bash

data/lib/mcp/client.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require "json"
+require "open3"
+require "securerandom"
+require_relative "constants"
+
+module MCP
+  class Client
+    attr_reader :command, :args, :process, :stdin, :stdout, :stderr, :wait_thread
+
+    def initialize(command:, args: [], name: "mcp-client", version: VERSION)
+      @command = command
+      @args = args
+      @process = nil
+      @name = name
+      @version = version
+    end
+
+    def connect
+      return if @process
+
+      start_server
+      initialize_connection
+      self
+    end
+
+    def running? = !@process.nil?
+
+    def list_tools
+      ensure_running
+      send_request({
+        jsonrpc: Constants::JSON_RPC_VERSION,
+        method: Constants::RequestMethods::TOOLS_LIST,
+        params: {},
+        id: SecureRandom.uuid
+      })
+    end
+
+    def call_tool(name:, args: {})
+      ensure_running
+      send_request({
+        jsonrpc: Constants::JSON_RPC_VERSION,
+        method: Constants::RequestMethods::TOOLS_CALL,
+        params: {
+          name: name,
+          arguments: args
+        },
+        id: SecureRandom.uuid
+      })
+    end
+
+    def close
+      return unless @process
+
+      @stdin.close
+      @stdout.close
+      @stderr.close
+      Process.kill("TERM", @process)
+      @wait_thread.join
+      @process = nil
+    rescue IOError, Errno::ESRCH
+      # プロセスが既に終了している場合は無視
+      @process = nil
+    end
+
+    private
+
+    def ensure_running
+      raise "Server process not running. Call #start first." unless running?
+    end
+
+    def initialize_connection
+      response = send_request({
+        jsonrpc: Constants::JSON_RPC_VERSION,
+        method: "initialize",
+        params: {
+          protocolVersion: Constants::PROTOCOL_VERSION,
+          client: {
+            name: @name,
+            version: @version
+          }
+        },
+        id: SecureRandom.uuid
+      })
+
+      @stdin.puts(JSON.generate({
+        jsonrpc: Constants::JSON_RPC_VERSION,
+        method: "notifications/initialized"
+      }))
+
+      response
+    end
+
+    def start_server
+      @stdin, @stdout, @stderr, @wait_thread = Open3.popen3(@command, *@args)
+      @process = @wait_thread.pid
+
+      Thread.new do
+        while (line = @stderr.gets)
+          warn "[MCP Server] #{line}"
+        end
+      rescue IOError
+        # ignore when stream is closed
+      end
+    end
+
+    def send_request(request)
+      @stdin.puts(JSON.generate(request))
+      response = @stdout.gets
+      raise "No response from server" unless response
+
+      result = JSON.parse(response, symbolize_names: true)
+      if result[:error]
+        raise "Server error: #{result[:error][:message]} (#{result[:error][:code]})"
+      end
+
+      result[:result]
+    rescue JSON::ParserError => e
+      raise "Invalid JSON response: #{e.message}"
+    end
+  end
+end

data/lib/mcp/constants.rb

@@ -3,6 +3,7 @@
 module MCP
   module Constants
     JSON_RPC_VERSION = "2.0"
+    PROTOCOL_VERSION = "2024-11-05"
 
     module ErrorCodes
       NOT_INITIALIZED = -32_002

data/lib/mcp/delegator.rb

@@ -15,6 +15,6 @@ module MCP
       end
     end
 
-    delegate :name, :resource, :tool
+    delegate :name, :version, :resource, :tool
   end
 end

data/lib/mcp/server.rb

@@ -3,26 +3,33 @@
 require "json"
 require "English"
 require "uri"
+require_relative "constants"
 
 module MCP
   class Server
-    attr_accessor :name
+    attr_writer :name, :version
     attr_reader :initialized
 
-    def initialize(name:, version: VERSION)
+    def initialize(name:, version: "0.1.0")
       @name = name
       @version = version
       @app = App.new
       @initialized = false
-      @supported_protocol_versions = [PROTOCOL_VERSION]
+      @supported_protocol_versions = [Constants::PROTOCOL_VERSION]
     end
 
-    def name(value = nil) # standard:disable Lint/DuplicateMethods
+    def name(value = nil)
       return @name if value.nil?
 
       @name = value
     end
 
+    def version(value = nil)
+      return @version if value.nil?
+
+      @version = value
+    end
+
     def tool(name, &block)
       @app.register_tool(name, &block)
     end
@@ -113,7 +120,7 @@ module MCP
         jsonrpc: MCP::Constants::JSON_RPC_VERSION,
         id: request[:id],
         result: {
-          protocolVersion: PROTOCOL_VERSION,
+          protocolVersion: Constants::PROTOCOL_VERSION,
           capabilities: {
             logging: {},
             prompts: {

data/lib/mcp/version.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
 module MCP
-  PROTOCOL_VERSION = "2024-11-05"
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/mcp.rb

@@ -8,6 +8,7 @@ require_relative "mcp/constants"
 require_relative "mcp/app"
 require_relative "mcp/server"
 require_relative "mcp/delegator"
+require_relative "mcp/client"
 
 module MCP
   class << self

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: mcp-rb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - funwarioisii
 bindir: bin
 cert_chain: []
-date: 2025-02-14 00:00:00.000000000 Z
+date: 2025-02-19 00:00:00.000000000 Z
 dependencies: []
 description: MCP-RB is a Ruby framework that provides a Sinatra-like DSL for implementing
   Model Context Protocol servers.
@@ -24,6 +24,7 @@ files:
 - lib/mcp/app.rb
 - lib/mcp/app/resource.rb
 - lib/mcp/app/tool.rb
+- lib/mcp/client.rb
 - lib/mcp/constants.rb
 - lib/mcp/delegator.rb
 - lib/mcp/server.rb
@@ -49,7 +50,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.3
 specification_version: 4
 summary: A lightweight Ruby framework for implementing MCP (Model Context Protocol)
   servers