solidus_mcp 0.2.0.rc1

data/lib/solidus_mcp/tool.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module SolidusMcp
+  # Metadata and implementation live together. Invoke through .execute; #call is
+  # deliberately protected so direct Ruby callers use the same checks as MCP.
+  class Tool
+    class << self
+      def inherited(subclass)
+        super
+        subclass.instance_variable_set(:@declaration, declaration.deep_dup)
+      end
+
+      %i[tool_name description category permission read_only].each do |key|
+        define_method(key) { |value| declaration[key] = value }
+      end
+
+      def ability(action, model)
+        declaration[:abilities] << [action.to_sym, model.to_s]
+      end
+
+      def input(name, required: false, **schema)
+        key = name.to_s
+        raise ArgumentError, "Duplicate input: #{key}" if declaration[:properties].key?(key)
+        declaration[:properties][key] = schema
+        declaration[:required] << key if required
+      end
+
+      def registration
+        declaration.deep_dup.merge(class_name: name,
+          input_schema: {type: "object", properties: declaration[:properties],
+                         required: declaration[:required], additionalProperties: false})
+      end
+
+      def execute(credential:, **arguments)
+        entry = SolidusMcp.registry.tools[registration.fetch(:tool_name).to_s]
+        raise AccessDenied, "Unregistered tool" unless entry && entry.class_name == name
+        policy = Policy.new(credential)
+        policy.authorize!(entry)
+        MCP::Tool::InputSchema.new(entry.input_schema).validate_arguments(arguments)
+        new(credential, policy).send(:call, **arguments)
+      end
+
+      private
+
+      def declaration
+        @declaration ||= {properties: {}, required: [], abilities: []}
+      end
+    end
+
+    attr_reader :credential, :policy
+
+    def initialize(credential, policy)
+      @credential = credential
+      @policy = policy
+    end
+
+    protected
+
+    def authorize!
+      policy.authorize!(SolidusMcp.registry.tools.fetch(self.class.registration.fetch(:tool_name).to_s))
+    end
+  end
+end

data/lib/solidus_mcp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SolidusMcp
+  VERSION = "0.2.0.rc1"
+end

data/lib/solidus_mcp.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "solidus_core"
+require "mcp"
+require "doorkeeper"
+require "solidus_mcp/version"
+require "solidus_mcp/configuration"
+require "solidus_mcp/administration"
+require "solidus_mcp/oauth"
+require "solidus_mcp/tool"
+require "solidus_mcp/registry"
+require "solidus_mcp/policy"
+require "solidus_mcp/connection_scopes"
+require "solidus_mcp/server"
+
+module SolidusMcp
+  class AccessDenied < StandardError; end
+
+  class ToolError < StandardError; end
+
+  class InsufficientScope < AccessDenied
+    attr_reader :scopes
+
+    def initialize(scopes)
+      @scopes = scopes
+      super("Additional OAuth authorization required: #{scopes.join(" ")}")
+    end
+  end
+
+  BUILTIN_TOOLS = %w[SearchProducts GetProduct GetProductVariants GetVariantPrices
+    UpdateProduct UpdateVariantPrice BulkUpdateVariantPrices GetInventoryLevels
+    SearchInventory SearchOrders GetOrder GetOrderStatus CreateProduct].map { |name| "SolidusMcp::Tools::#{name}" }.freeze
+
+  class << self
+    attr_writer :registry
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    def registry
+      @registry ||= Registry.new.seal!
+    end
+
+    def rebuild_registry!
+      catalog = Registry.new
+      (BUILTIN_TOOLS + configuration.custom_tools).each { |name| catalog.register(name.constantize) }
+      self.registry = catalog.seal!
+    end
+  end
+end
+
+require "solidus_mcp/engine"

data/lib/tasks/solidus_mcp.rake

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+namespace :solidus_mcp do
+  desc "Run engine migrations directly from the installed gem (after host migrations)"
+  task migrate: :environment do
+    context = ActiveRecord::MigrationContext.new(SolidusMcp::Engine.root.join("db/migrate").to_s)
+    context.migrate
+  end
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: solidus_mcp
+version: !ruby/object:Gem::Version
+  version: 0.2.0.rc1
+platform: ruby
+authors:
+- Michael Caviness
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-11-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: solidus_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.8.1
+- !ruby/object:Gem::Dependency
+  name: doorkeeper
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.9'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+description: Standard store tools, OAuth transport, explicit connection permissions
+  and optional SolidusAdmin controls.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- app/assets/stylesheets/solidus_mcp/admin.css
+- app/controllers/concerns/solidus_mcp/http_access.rb
+- app/controllers/solidus_admin/mcp_administrators_controller.rb
+- app/controllers/solidus_admin/mcp_connections_controller.rb
+- app/controllers/solidus_mcp/authorizations_controller.rb
+- app/controllers/solidus_mcp/endpoint_controller.rb
+- app/controllers/solidus_mcp/metadata_controller.rb
+- app/controllers/solidus_mcp/registrations_controller.rb
+- app/controllers/solidus_mcp/tokens_controller.rb
+- app/models/solidus_mcp/administrator.rb
+- app/models/solidus_mcp/administrator_change.rb
+- app/models/solidus_mcp/connection_policy.rb
+- app/models/solidus_mcp/credential.rb
+- app/models/solidus_mcp/policy_change.rb
+- app/services/solidus_mcp/client_registration.rb
+- app/services/solidus_mcp/price_update.rb
+- app/services/solidus_mcp/serializers.rb
+- app/tools/solidus_mcp/tools/base.rb
+- app/tools/solidus_mcp/tools/bulk_update_variant_prices.rb
+- app/tools/solidus_mcp/tools/create_product.rb
+- app/tools/solidus_mcp/tools/get_inventory_levels.rb
+- app/tools/solidus_mcp/tools/get_order.rb
+- app/tools/solidus_mcp/tools/get_order_status.rb
+- app/tools/solidus_mcp/tools/get_product.rb
+- app/tools/solidus_mcp/tools/get_product_variants.rb
+- app/tools/solidus_mcp/tools/get_variant_prices.rb
+- app/tools/solidus_mcp/tools/search_inventory.rb
+- app/tools/solidus_mcp/tools/search_orders.rb
+- app/tools/solidus_mcp/tools/search_products.rb
+- app/tools/solidus_mcp/tools/update_product.rb
+- app/tools/solidus_mcp/tools/update_variant_price.rb
+- app/views/solidus_admin/mcp_administrators/_account_search.html.erb
+- app/views/solidus_admin/mcp_administrators/index.html.erb
+- app/views/solidus_admin/mcp_connections/_permission_selection.html.erb
+- app/views/solidus_admin/mcp_connections/_permissions.html.erb
+- app/views/solidus_admin/mcp_connections/edit.html.erb
+- app/views/solidus_admin/mcp_connections/index.html.erb
+- app/views/solidus_mcp/authorizations/new.html.erb
+- config/locales/en.yml
+- config/routes.rb
+- db/migrate/20261023000000_create_solidus_mcp_connection_policies.rb
+- db/migrate/20261024000000_add_solidus_mcp_oauth_attributes.rb
+- db/migrate/20261024010000_add_deleted_at_to_solidus_mcp_connection_policies.rb
+- db/migrate/20261108000000_create_solidus_mcp_administrators.rb
+- docs/administration.md
+- lib/solidus_mcp.rb
+- lib/solidus_mcp/administration.rb
+- lib/solidus_mcp/configuration.rb
+- lib/solidus_mcp/connection_scopes.rb
+- lib/solidus_mcp/engine.rb
+- lib/solidus_mcp/oauth.rb
+- lib/solidus_mcp/policy.rb
+- lib/solidus_mcp/registry.rb
+- lib/solidus_mcp/server.rb
+- lib/solidus_mcp/tool.rb
+- lib/solidus_mcp/version.rb
+- lib/tasks/solidus_mcp.rake
+homepage: https://github.com/michaelmichael/solidus_mcp
+licenses:
+- BSD-3-Clause
+metadata:
+  source_code_uri: https://github.com/michaelmichael/solidus_mcp
+  bug_tracker_uri: https://github.com/michaelmichael/solidus_mcp/issues
+  changelog_uri: https://github.com/michaelmichael/solidus_mcp/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Self-contained MCP administration for Solidus stores
+test_files: []