hub_kernel-mcp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3113f06c6af7ead9f6321fdb00d2518557f17d03fbc79f3684260c2e146b641e
+  data.tar.gz: aaa88888cd32c9ea2e28e731c968596d27ce27360c5b4725cb6020c7146de1ba
+SHA512:
+  metadata.gz: facf0d8f1a0d4f9f68ee8f21ee33623dcbcda13fa9d3905337c898b047e0b8f67c16aab0374d6254135b15413e6de2b2efb1b6e972a3c2b2212790196d47ca69
+  data.tar.gz: ba377f8a885f55972913d953daf6c766609880298cba383e2507ebcfdd564c538ed6d13c669edfa4cdb7540f620b1326e40106d35d7e773912af37a8d039ca00

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright tylercschneider
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,56 @@
+# hub_kernel-mcp
+
+Serves the methods every hub a host serves exposes as MCP tools, at one address. Every
+request goes through the host's own sign-in, then hub_kernel's permission check and account
+scope.
+
+## Usage
+
+Add the gem, then in an initializer name the controller the endpoint inherits from and the two
+methods on it that give the person and the account a request is made for:
+
+```ruby
+HubKernel::Mcp.base_controller = "Api::HubBaseController"
+HubKernel::Mcp.person_method = :current_person
+HubKernel::Mcp.account_method = :current_account
+```
+
+The hubs served are the host's one list in hub_kernel-interface, which every interface gem
+serves:
+
+```ruby
+Rails.application.config.to_prepare do
+  HubKernel::Interface.hubs = [ Supplies, { "money" => Billing::Ledger } ]
+end
+```
+
+Mount the engine:
+
+```ruby
+mount HubKernel::Mcp::Engine => "/mcp"
+```
+
+The endpoint takes MCP's JSON-RPC requests by POST. `initialize` answers the server's name,
+its version, a tools capability, and the protocol version the client asked for when the gem
+supports it, or else the newest it does: 2025-11-25, 2025-06-18, 2025-03-26 or 2024-11-05. A
+notification is accepted with no answer.
+
+`tools/list` returns one tool for each method the caller may call, across every served hub.
+Each tool is named `<hub>__<method>`, where the hub part is the name the hub is served at, and
+its input schema names the values the method takes:
+
+```json
+{ "name": "supplies__price_of", "inputSchema": { "type": "object", "properties": { "item": {} } } }
+```
+
+A caller the host's sign-in refuses is refused before any hub is asked.
+
+## Installation
+
+```ruby
+gem "hub_kernel-mcp"
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+require "bundler/gem_tasks"

data/app/controllers/hub_kernel/mcp/messages_controller.rb

@@ -0,0 +1,38 @@
+module HubKernel
+  module Mcp
+    class MessagesController < HubKernel::Mcp.base_controller.constantize
+      PROTOCOL_VERSIONS = %w[2025-11-25 2025-06-18 2025-03-26 2024-11-05].freeze
+
+      def create
+        return head :accepted unless params.key?(:id)
+
+        render json: { jsonrpc: "2.0", id: params[:id], result: answer }
+      end
+
+      private
+
+      def answer
+        case params[:method]
+        when "initialize" then initialized
+        when "tools/list" then { tools: tools }
+        end
+      end
+
+      def initialized = { protocolVersion: protocol_version, serverInfo: { name: "hub_kernel-mcp", version: HubKernel::Mcp::VERSION }, capabilities: { tools: {} } }
+
+      def protocol_version = PROTOCOL_VERSIONS.include?(params.dig(:params, :protocolVersion)) ? params.dig(:params, :protocolVersion) : PROTOCOL_VERSIONS.first
+
+      def tools
+        HubKernel::Interface.served.flat_map do |served_name, hub|
+          hub.exposures_for(person: caller_person, account: caller_account).map { |exposure| tool(served_name, exposure) }
+        end
+      end
+
+      def tool(served_name, exposure) = { name: "#{served_name}__#{exposure.name}", inputSchema: { type: "object", properties: exposure.takes.index_with { {} } } }
+
+      def caller_person = send(HubKernel::Mcp.person_method)
+
+      def caller_account = send(HubKernel::Mcp.account_method)
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,3 @@
+HubKernel::Mcp::Engine.routes.draw do
+  post "/", to: "messages#create"
+end

data/lib/hub_kernel/mcp/engine.rb

@@ -0,0 +1,7 @@
+module HubKernel
+  module Mcp
+    class Engine < ::Rails::Engine
+      isolate_namespace HubKernel::Mcp
+    end
+  end
+end

data/lib/hub_kernel/mcp/version.rb

@@ -0,0 +1,5 @@
+module HubKernel
+  module Mcp
+    VERSION = "0.1.0"
+  end
+end

data/lib/hub_kernel/mcp.rb

@@ -0,0 +1,11 @@
+require "hub_kernel-interface"
+require "hub_kernel/mcp/version"
+require "hub_kernel/mcp/engine"
+
+module HubKernel
+  module Mcp
+    mattr_accessor :base_controller, default: "ActionController::API"
+    mattr_accessor :person_method
+    mattr_accessor :account_method
+  end
+end

data/lib/hub_kernel-mcp.rb

@@ -0,0 +1 @@
+require "hub_kernel/mcp"

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: hub_kernel-mcp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- tylercschneider
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.3
+- !ruby/object:Gem::Dependency
+  name: hub_kernel-interface
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: hub_kernel-mcp serves the methods every hub a host serves exposes as
+  MCP tools at one address, with every call going through the host's sign-in, permission
+  check and account scope.
+email:
+- tylercschneider@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/controllers/hub_kernel/mcp/messages_controller.rb
+- config/routes.rb
+- lib/hub_kernel-mcp.rb
+- lib/hub_kernel/mcp.rb
+- lib/hub_kernel/mcp/engine.rb
+- lib/hub_kernel/mcp/version.rb
+homepage: https://github.com/DYB-Development/hub_kernel-mcp
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/DYB-Development/hub_kernel-mcp
+  source_code_uri: https://github.com/DYB-Development/hub_kernel-mcp
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Serves a hub_kernel hub's exposed methods as MCP tools.
+test_files: []