ruby_llm-mcp 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 328e09780647e7ef9a35aac8a8fd8e0b1c84aded38239b4ad9b08803e1d638d3
-  data.tar.gz: f0f1022e6917f56b95ecfd4540fb517245f6b5450f9369d4cee2cc34e2eb0934
+  metadata.gz: 871fadee0f0166df56c6e8ef4ce2a6598c7875af9ca05631687cab1966ccb4e9
+  data.tar.gz: 6cbefa984fd7b541005be0f3f05c3970ab511c90afec9d135212dca33127d992
 SHA512:
-  metadata.gz: d52fcbfb4fe1c1ebae1fece801a0f9b20a9aa467f7a3333c65e0db4fcc1ee0038df571ad4d7cdae2d8863d4d4ddd29c019a3ff245de5970142dcdccf7228ae45
-  data.tar.gz: 471a551100918f7a86c6fe22b0065f340ec7ed87a4b1d709f49ce8c782b564532e840b6f160d5c082ef5f08734d1bd3ad59fb514f119150ec37f42e626678cc4
+  metadata.gz: 43b1fcb2d2fd8d6d1ebf7b8a43266443e72be5551ae9866a565bd38f7a90b98832294aadadb562d58a82dae24ff72251fe9eda91aab06a75df061413885c0560
+  data.tar.gz: 9a72ae094803de509b3ec447a43899a001ebd857d7f1085cb31f36a923d189324f7766ed37249866f0fc38e82fb962c11b00737f6821a7e6d723c6a30aa537aa

data/README.md

@@ -399,6 +399,23 @@ end
 
 You can also avoid this completely manually start and stop the clients if you so choose.
 
+If you want to use the clients outside of the block, you can use the `clients` method to get the clients.
+
+```ruby
+clients = RubyLLM::MCP.establish_connection
+chat = RubyLLM.chat(model: "gpt-4")
+chat.with_tools(*clients.tools)
+
+response = chat.ask("Hello, world!")
+puts response
+```
+
+However, you will be responsible for closing the connection when you are done with it.
+
+```ruby
+RubyLLM::MCP.close_connection
+```
+
 ## Client Lifecycle Management
 
 You can manage the MCP client connection lifecycle:

data/lib/generators/ruby_llm/mcp/install_generator.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module RubyLlm
+  module Mcp
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+        source_root File.expand_path("templates", __dir__)
+
+        desc "Install RubyLLM MCP configuration files"
+
+        def create_initializer
+          template "initializer.rb", "config/initializers/ruby_llm_mcp.rb"
+        end
+
+        def create_config_file
+          template "mcps.yml", "config/mcps.yml"
+        end
+
+        def display_readme
+          readme "README.txt" if behavior == :invoke
+        end
+      end
+    end
+  end
+end

data/lib/generators/ruby_llm/mcp/templates/README.txt

@@ -0,0 +1,32 @@
+RubyLLM MCP has been successfully installed!
+
+The following files have been created:
+
+  config/initializers/ruby_llm_mcp.rb - Main configuration file
+  config/mcps.json                    - MCP servers configuration
+
+Next steps:
+
+1. Edit config/initializers/ruby_llm_mcp.rb to configure your MCP settings
+2. Edit config/mcps.json to define your MCP servers
+3. Install any MCP servers you want to use (e.g., npm install @modelcontextprotocol/server-filesystem) or use remote MCPs
+4. Update environment variables for any MCP servers that require authentication
+
+Example usage in your Rails application:
+
+  # With Ruby::MCP installed in a controller or service
+  clients = RubyLLM::MCP.clients
+
+  # Get all tools use the configured client
+  tools = RubyLLM::MCP.tools
+
+  # Or use the configured client
+  client = RubyLLM::MCP.clients["file-system"]
+
+  # Or use the configured client
+  tools = client.tools
+
+
+For more information, visit: https://github.com/patvice/ruby_llm-mcp
+
+===============================================================================

data/lib/generators/ruby_llm/mcp/templates/initializer.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# Configure RubyLLM MCP
+RubyLLM::MCP.configure do |config|
+  # Request timeout in milliseconds
+  config.request_timeout = 8000
+
+  # Maximum connections in the pool
+  config.max_connections = Float::INFINITY
+
+  # Pool timeout in seconds
+  config.pool_timeout = 5
+
+  # Enable complex parameter support for various providers
+  config.support_complex_parameters!
+
+  # Path to MCPs configuration file
+  config.config_path = Rails.root.join("config", "mcps.yml")
+
+  # Launch MCPs (:automatic, :manual)
+  config.launch_control = :automatic
+
+  # Configure roots for file system access
+  # config.roots = [
+  #   Rails.root.to_s
+  # ]
+
+  # Configure sampling (optional)
+  config.sampling.enabled = false
+
+  # Set preferred model for sampling
+  # config.sampling.preferred_model do
+  #   # Return the preferred model name
+  #   "claude-3-5-sonnet-20240620"
+  # end
+
+  # Set a guard for sampling
+  # config.sampling.guard do
+  #   # Return true to enable sampling, false to disable
+  #   Rails.env.development?
+  # end
+end

data/lib/generators/ruby_llm/mcp/templates/mcps.yml

@@ -0,0 +1,9 @@
+mcp_servers:
+  filesystem:
+    transport_type: stdio
+    command: npx
+    args:
+      - "@modelcontextprotocol/server-filesystem"
+      - "<%%= Rails.root %>"
+    env: {}
+    with_prefix: true

data/lib/ruby_llm/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module RubyLLM
   module MCP
-    VERSION = "0.5.0"
+    VERSION = "0.5.1"
   end
 end

data/lib/ruby_llm/mcp.rb

@@ -33,8 +33,18 @@ module RubyLLM
 
     def establish_connection(&)
       clients.each(&:start)
-      yield clients
-    ensure
+      if block_given?
+        begin
+          yield clients
+        ensure
+          close_connection
+        end
+      else
+        clients
+      end
+    end
+
+    def close_connection
       clients.each do |client|
         client.stop if client.alive?
       end

data/lib/tasks/release.rake

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+namespace :release do
+  desc "Release a new version of the gem"
+  task :version do
+    # Load the current version from version.rb
+    require_relative "../../lib/ruby_llm/schema/version"
+    version = RubyLlm::Schema::VERSION
+
+    puts "Releasing version #{version}..."
+
+    # Make sure we are on the main branch
+    system "git checkout main"
+    system "git pull origin main"
+
+    # Create a new tag for the version
+    system "git tag -a v#{version} -m 'Release version #{version}'"
+    system "git push origin v#{version}"
+
+    system "gem build ruby_llm-mcp.gemspec"
+    system "gem push ruby_llm-mcp-#{version}.gem"
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Patrick Vice
@@ -65,6 +65,10 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- lib/generators/ruby_llm/mcp/install_generator.rb
+- lib/generators/ruby_llm/mcp/templates/README.txt
+- lib/generators/ruby_llm/mcp/templates/initializer.rb
+- lib/generators/ruby_llm/mcp/templates/mcps.yml
 - lib/ruby_llm/chat.rb
 - lib/ruby_llm/mcp.rb
 - lib/ruby_llm/mcp/attachment.rb
@@ -121,6 +125,7 @@ files:
 - lib/ruby_llm/mcp/transports/streamable_http.rb
 - lib/ruby_llm/mcp/transports/timeout.rb
 - lib/ruby_llm/mcp/version.rb
+- lib/tasks/release.rake
 homepage: https://github.com/patvice/ruby_llm-mcp
 licenses:
 - MIT