foobara-mcp-connector 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e4048b44adee3a3ab2d8ed0092495c6cb017901be71c96bfb328aa5fbaaed29
-  data.tar.gz: 244c334f637a11a5f78f41cb1bc26c228cf315237b8755d076bbdd3ef7653e48
+  metadata.gz: c7f2399bed1c8f29efdfd89bf12b38251d74eece5ece41708e5ce04bc8838fd3
+  data.tar.gz: e73a8e7afecf4792a62c87097b78488d52f7913e752c7d63ccc37ede25a2505d
 SHA512:
-  metadata.gz: 213609332b4d1a02d950f6e046eb57f4d41cf91b1102a57c200dd159684e8fda53b936cfb8bf8e7bbcdd831a55db832bad3e63816ed04ccedf229319349f9110
-  data.tar.gz: 84c7bcde7c0d0696685f886f289cecddf680bb89383c1954fa1605e4bef225b19fd85fc3c2401f3e9af4a1e37ce2154b533a8f7314f793753326865071d687b4
+  metadata.gz: 6f007511b3ea56495751b0d184b79190d6a07efc19e142bfa6e557f5ea039523762fb6ac0da55e67a89ffde52be40317e44a3b7a9c17ce97121122fd98139498
+  data.tar.gz: b2deac186cd83fd33268ca054f3d022c8ae47e60849d3f1f9347e608c709645d85a33107c4210e5b0b7dde9e07c8b610759841d1f87496fcd5f208f095063351

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.0.3] - 2025-04-14
+
+- Grab version from gemspec instead of version.rb
+
+## [0.0.2] - 2025-04-12
+
+- Add more examples
+- Update README.md with new examples
+- Add description to gem
+
 ## [0.0.1] - 2025-04-11
 
 - Initial release

data/README.md

@@ -1,6 +1,18 @@
 # Foobara::McpConnector
 
-Exposes Foobara commands according to the Model Context Protocol specification
+Exposes Foobara commands according to the Model Context Protocol (MCP) specification
+
+<!-- TOC -->
+* [Foobara::McpConnector](#foobaramcpconnector)
+  * [Installation](#installation)
+  * [Usage](#usage)
+    * [Super basic example](#super-basic-example)
+    * [An example with entities](#an-example-with-entities)
+    * [A destructive example](#a-destructive-example)
+    * [Moar examples](#moar-examples)
+  * [Contributing](#contributing)
+  * [License](#license)
+<!-- TOC -->
 
 ## Installation
 
@@ -11,6 +23,8 @@ Typical stuff: add `gem "foobara-mcp-connector` to your Gemfile or .gemspec file
 
 You can find examples in `examples/`
 
+### Super basic example
+
 Let's create a simple Foobara command:
 
 ```ruby
@@ -96,18 +110,133 @@ $ claude
 ● 125
 > Thanks!
 ● You're welcome!
-╭───────────────────────────────────────────────────────────────────────╮
-│ >                                                                     │
-╰───────────────────────────────────────────────────────────────────────╯
 ```
 
-Please see the examples/ directory for more examples
+### An example with entities
+
+Let's say we have a model (see examples/capybaras.rb):
+
+```ruby
+class Capybara < Foobara::Entity
+  attributes do
+    id :integer
+    name :string, :required
+    year_of_birth :integer, :required
+  end
+
+  primary_key :id
+end
+```
+
+As well as some commands like `FindAllCapybaras`, `CreateCapybara`, and `UpdateCapybara`
+(see examples/capybara_commands.rb)
+
+We can write an MCP connector to expose those commands so we can ask questions that require
+running those commands to answer:
+
+```ruby
+require "foobara/mcp_connector"
+require_relative "capybara_commands"
+
+CreateCapybara.run!(name: "Fumiko", year_of_birth: 2020)
+CreateCapybara.run!(name: "Barbara", year_of_birth: 2019)
+CreateCapybara.run!(name: "Basil", year_of_birth: 2021)
+
+mcp_connector = Foobara::McpConnector.new
+mcp_connector.connect(FindAllCapybaras)
+
+mcp_connector.run_stdio_server
+```
+
+We can now ask a tool like claude a relevant question:
+
+```
+$ claude
+> Which Capybara is the oldest?
+● mcp-test:FindAllCapybaras (MCP)()…
+  ⎿  [
+       {
+         "name": "Fumiko",
+         "year_of_birth": 2020,
+         "id": 1
+
+     … +7 lines (ctrl+r to expand)
+
+         "name": "Basil",
+         "year_of_birth": 2021,
+         "id": 3
+       }
+     ]
+
+● Barbara (born in 2019)
+> Thanks!
+● You're welcome!
+```
+
+### A destructive example
+
+Let's say we would like to mutate data. Let's pretend we've accidentally entered a year-of-birth
+in a 2-digit format where a 4-digit format was expected. Let's do that and also expose our UpdateCapybara
+command:
+
+```ruby
+# We will simulate a year accidentally being entered with a 2-digit format where a 4-digit format was expected
+UpdateCapybara.run!(id: barbara.id, year_of_birth: 19)
+
+mcp_connector = Foobara::McpConnector.new
+
+mcp_connector.connect(FindAllCapybaras)
+mcp_connector.connect(UpdateCapybara)
+
+mcp_connector.run_stdio_server
+```
+
+Now we can ask a tool like claude to find and fix our data:
+
+```
+$ claude
+> Hi! There's a Capybara whose birth year was entered incorrectly. Can you find which one
+  and fix it? Thanks!
+● I'll help find and fix the capybara with the incorrect birth year. Let me search for the
+  capybaras first.
+● mcp-test:FindAllCapybaras (MCP)()…
+  ⎿  [
+       {
+         "name": "Fumiko",
+         "year_of_birth": 2020,
+         "id": 1
+
+     … +7 lines (ctrl+r to expand)
+
+         "name": "Basil",
+         "year_of_birth": 2021,
+         "id": 3
+       }
+     ]
+● It looks like Barbara (id 2) has an incorrect birth year of 19, which is too low. Let me
+  fix that to 2019.
+● mcp-test:UpdateCapybara (MCP)(id: 2, year_of_birth: 2019)…
+  ⎿  {
+       "name": "Barbara",
+       "year_of_birth": 2019,
+       "id": 2
+     }
+● Fixed! Barbara's birth year has been updated from 19 to 2019.
+> Great! Thanks!
+● You're welcome!
+```
+
+### Moar examples
+
+Please see the examples/ directory for executable scripts of these examples.
 
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub
 at https://github.com/foobara/mcp-connector
 
+Feel free to reach out if you'd like help with this gem or if you'd like to help with this gem!
+
 ## License
 
 This project is licensed under the MPL-2.0 license. Please see LICENSE.txt for more info.

data/src/mcp_connector.rb

@@ -25,9 +25,7 @@ module Foobara
     end
 
     def default_server_version
-      require_relative "../version"
-
-      Foobara::McpConnectorVersion::VERSION
+      Gem.loaded_specs["foobara-mcp-connector"].version.to_s
     end
 
     def default_instructions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foobara-mcp-connector
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Miles Georgi
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.97
+        version: 0.0.101
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.97
+        version: 0.0.101
 - !ruby/object:Gem::Dependency
   name: foobara-json-schema-generator
   requirement: !ruby/object:Gem::Requirement
@@ -56,7 +56,6 @@ files:
 - src/request.rb
 - src/session.rb
 - src/stdio_runner.rb
-- version.rb
 homepage: https://github.com/foobara/mcp-connector
 licenses:
 - MPL-2.0
@@ -81,5 +80,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.7
 specification_version: 4
-summary: No description. Add one.
+summary: Gives an easy way to expose your Foobara commands to tools like Claude Code
+  via the Model Context Protocol (MCP)
 test_files: []

data/version.rb

@@ -1,9 +0,0 @@
-module Foobara
-  module McpConnectorVersion
-    VERSION = "0.0.1".freeze
-
-    local_ruby_version = File.read("#{__dir__}/.ruby-version").chomp
-    local_ruby_version_minor = local_ruby_version[/\A(\d+\.\d+)\.\d+\z/, 1]
-    MINIMUM_RUBY_VERSION = ">= #{local_ruby_version_minor}.0".freeze
-  end
-end