mcp_on_ruby 1.0.0 → 2.0.0

data/lib/mcp_on_ruby/version.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
 module McpOnRuby
-  VERSION = "1.0.0"
-  PROTOCOL_VERSION = "2024-11-05"
-end
+  VERSION = "2.0.0"
+end

data/lib/mcp_on_ruby/warden_hook.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module McpOnRuby
+  # Signs in the stdio user for Warden and Devise apps, for the duration of one dispatched request.
+  #
+  # The user is read from the request env, never from a header, so HTTP clients cannot set it.
+  # Nothing is written to the session.
+  module WardenHook
+    module_function
+
+    def install!
+      return if @installed || !defined?(::Warden::Manager)
+
+      ::Warden::Manager.on_request do |proxy|
+        user = proxy.env[McpOnRuby::USER_ENV_KEY]
+        proxy.set_user(user, scope: McpOnRuby.configuration.warden_scope, store: false, run_callbacks: false) if user
+      end
+      @installed = true
+    end
+  end
+end

data/lib/mcp_on_ruby.rb

@@ -1,142 +1,64 @@
 # frozen_string_literal: true
 
-require 'logger'
-require 'json'
-require 'json-schema'
-require 'rack'
-require 'webrick'
+require "mcp"
+require "active_support"
+require "active_support/core_ext"
+require "mcp_on_ruby/version"
 
-require_relative 'mcp_on_ruby/version'
-require_relative 'mcp_on_ruby/errors'
-require_relative 'mcp_on_ruby/configuration'
-require_relative 'mcp_on_ruby/server'
-require_relative 'mcp_on_ruby/tool'
-require_relative 'mcp_on_ruby/resource'
-require_relative 'mcp_on_ruby/transport'
-
-# Rails integration if available
-if defined?(Rails)
-  require_relative 'mcp_on_ruby/railtie'
-end
-
-# Production-ready Model Context Protocol implementation for Rails
+# MCP on Ruby exposes Rails controller actions as Model Context Protocol tools.
 module McpOnRuby
-  class << self
-    attr_writer :logger
-    attr_accessor :configuration
+  class Error < StandardError; end
 
-    # Configure the library
-    # @yield [Configuration] The configuration object
-    # @return [Configuration] The configuration object
-    def configure
-      self.configuration ||= Configuration.new
-      yield(configuration) if block_given?
-      configuration
-    end
+  # Raised when tool declarations cannot be served, for example a typo in an action name.
+  class ConfigurationError < Error; end
 
-    # Get the logger
-    # @return [Logger] The logger
-    def logger
-      @logger ||= Logger.new($stdout).tap do |log|
-        log.progname = 'McpOnRuby'
-        log.level = configuration&.log_level || Logger::INFO
-      end
-    end
+  # Rack env key set on requests dispatched by an MCP tool call; holds the tool name.
+  TOOL_ENV_KEY = "mcp_on_ruby.tool"
 
-    # Create a new MCP server
-    # @param options [Hash] Server configuration options
-    # @yield [Server] The server instance for configuration
-    # @return [Server] The configured server
-    def server(options = {}, &block)
-      Server.new(options, &block)
-    end
+  # Rack env key holding the user a local (stdio) session acts as.
+  USER_ENV_KEY = "mcp_on_ruby.user"
 
-    # Create a tool with DSL
-    # @param name [String] Tool name
-    # @param description [String] Tool description
-    # @param input_schema [Hash] JSON Schema for validation
-    # @param options [Hash] Additional options (metadata, tags)
-    # @param block [Proc] Tool implementation
-    # @return [Tool] The created tool
-    def tool(name, description = '', input_schema = {}, **options, &block)
-      raise ArgumentError, 'Tool implementation block is required' unless block_given?
+  autoload :CallContext, "mcp_on_ruby/call_context"
+  autoload :Configuration, "mcp_on_ruby/configuration"
+  autoload :Controller, "mcp_on_ruby/controller"
+  autoload :Declaration, "mcp_on_ruby/declaration"
+  autoload :Dispatcher, "mcp_on_ruby/dispatcher"
+  autoload :Doctor, "mcp_on_ruby/doctor"
+  autoload :Endpoint, "mcp_on_ruby/endpoint"
+  autoload :Registry, "mcp_on_ruby/registry"
+  autoload :Result, "mcp_on_ruby/result"
+  autoload :Schema, "mcp_on_ruby/schema"
+  autoload :ServerFactory, "mcp_on_ruby/server_factory"
+  autoload :Stdio, "mcp_on_ruby/stdio"
+  autoload :ToolTable, "mcp_on_ruby/tool_table"
+  autoload :TestHelper, "mcp_on_ruby/test_helper"
+  autoload :ToolSpec, "mcp_on_ruby/tool_spec"
+  autoload :WardenHook, "mcp_on_ruby/warden_hook"
 
-      Class.new(Tool) do
-        define_method :execute do |arguments, context|
-          case block.arity
-          when 0
-            instance_exec(&block)
-          when 1
-            instance_exec(arguments, &block)
-          else
-            instance_exec(arguments, context, &block)
-          end
-        end
-      end.new(
-        name: name,
-        description: description,
-        input_schema: input_schema,
-        metadata: options[:metadata] || {},
-        tags: options[:tags] || []
-      )
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
     end
 
-    # Create a resource with DSL
-    # @param uri [String] Resource URI
-    # @param options [Hash] Resource options (name, description, etc.)
-    # @param block [Proc] Resource implementation
-    # @return [Resource] The created resource
-    def resource(uri, **options, &block)
-      raise ArgumentError, 'Resource implementation block is required' unless block_given?
+    # The tools exposed by the running application.
+    def registry
+      @registry ||= Registry.new
+    end
 
-      Class.new(Resource) do
-        define_method :fetch_content do |params, context|
-          case block.arity
-          when 0
-            instance_exec(&block)
-          when 1
-            instance_exec(params, &block)
-          else
-            instance_exec(params, context, &block)
-          end
-        end
-      end.new(
-        uri: uri,
-        name: options[:name],
-        description: options[:description] || '',
-        mime_type: options[:mime_type] || 'application/json',
-        metadata: options[:metadata] || {},
-        tags: options[:tags] || []
-      )
+    # Builds MCP servers for HTTP requests and stdio sessions.
+    def server_factory
+      @server_factory ||= ServerFactory.new
     end
 
-    # Broadcast resource update to connected SSE clients
-    # @param uri [String] Resource URI that was updated
-    # @param event_type [String] Type of event
-    def broadcast_resource_update(uri, event_type = 'resource_updated')
-      # This would be implemented when SSE is fully integrated
-      logger.info("Resource update broadcasted: #{uri} (#{event_type})")
+    def configure
+      yield configuration
     end
 
-    # Mount MCP server in Rails application
-    # @param app [Rails::Application] The Rails application
-    # @param options [Hash] Mounting options
-    # @yield [Server] The server instance for configuration
-    # @return [Server] The mounted server
-    def mount_in_rails(app, **options, &block)
-      server = self.server(options, &block)
-      
-      # Mount the transport middleware
-      app.config.middleware.use(
-        Transport::RackMiddleware,
-        server: server,
-        **options
-      )
-      
-      server
+    # Restores the default configuration. Intended for tests.
+    def reset_configuration!
+      @configuration = Configuration.new
     end
   end
 end
 
-# Alias for convenience
-MCP = McpOnRuby
+require "mcp_on_ruby/engine" if defined?(Rails::Engine)

data/lib/tasks/mcp_on_ruby.rake

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+namespace :mcp do
+  desc "Serve this app's MCP tools over stdio for local agents"
+  task stdio: :environment do
+    McpOnRuby::Stdio.run
+  end
+
+  desc "List the controller actions exposed as MCP tools"
+  task tools: :environment do
+    print McpOnRuby::ToolTable.render(McpOnRuby.registry.tools)
+  end
+
+  desc "Check the MCP on Ruby setup"
+  task doctor: :environment do
+    doctor = McpOnRuby::Doctor.new.run
+    print doctor.report
+    exit(1) unless doctor.ok?
+  end
+end

metadata

@@ -1,193 +1,122 @@
 --- !ruby/object:Gem::Specification
 name: mcp_on_ruby
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Nagendra Dhanakeerthi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-28 00:00:00.000000000 Z
+date: 2026-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: json-schema
+  name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rack
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
-- !ruby/object:Gem::Dependency
-  name: webrick
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '9'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '1.8'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.12'
-  type: :development
+        version: 1.8.2
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.50'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '1.8'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.50'
+        version: 1.8.2
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.22'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.22'
-- !ruby/object:Gem::Dependency
-  name: webmock
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.18'
-  type: :development
+        version: '9'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.18'
-- !ruby/object:Gem::Dependency
-  name: rack-test
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2.1'
-description: A comprehensive Ruby library for building Model Context Protocol (MCP)
-  servers in Rails applications, featuring tools, resources, authentication, and real-time
-  capabilities.
+        version: '9'
+description: MCP on Ruby exposes existing Rails controller actions as Model Context
+  Protocol (MCP) tools. Agents call your app through the same routes, authentication,
+  policies, params, and JSON responses your users already rely on. Built on the official
+  mcp gem; serves Streamable HTTP and stdio.
 email:
 - nagendra.dhanakeerthi@gmail.com
-executables:
-- console
-- setup
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
-- bin/console
-- bin/setup
-- docs/advanced-usage.md
-- docs/api-reference.md
-- docs/testing.md
-- examples/claude/README.md
-- examples/claude/claude-bridge.js
+- config/routes.rb
+- lib/generators/mcp_on_ruby/expose/expose_generator.rb
+- lib/generators/mcp_on_ruby/install/install_generator.rb
+- lib/generators/mcp_on_ruby/install/templates/initializer.rb
 - lib/mcp_on_ruby.rb
+- lib/mcp_on_ruby/call_context.rb
 - lib/mcp_on_ruby/configuration.rb
-- lib/mcp_on_ruby/errors.rb
-- lib/mcp_on_ruby/generators/install_generator.rb
-- lib/mcp_on_ruby/generators/resource_generator.rb
-- lib/mcp_on_ruby/generators/templates/README
-- lib/mcp_on_ruby/generators/templates/application_resource.rb
-- lib/mcp_on_ruby/generators/templates/application_tool.rb
-- lib/mcp_on_ruby/generators/templates/initializer.rb
-- lib/mcp_on_ruby/generators/templates/resource.rb
-- lib/mcp_on_ruby/generators/templates/resource_spec.rb
-- lib/mcp_on_ruby/generators/templates/sample_resource.rb
-- lib/mcp_on_ruby/generators/templates/sample_tool.rb
-- lib/mcp_on_ruby/generators/templates/tool.rb
-- lib/mcp_on_ruby/generators/templates/tool_spec.rb
-- lib/mcp_on_ruby/generators/tool_generator.rb
-- lib/mcp_on_ruby/railtie.rb
-- lib/mcp_on_ruby/resource.rb
-- lib/mcp_on_ruby/server.rb
-- lib/mcp_on_ruby/tool.rb
-- lib/mcp_on_ruby/transport.rb
+- lib/mcp_on_ruby/controller.rb
+- lib/mcp_on_ruby/declaration.rb
+- lib/mcp_on_ruby/dispatcher.rb
+- lib/mcp_on_ruby/doctor.rb
+- lib/mcp_on_ruby/endpoint.rb
+- lib/mcp_on_ruby/engine.rb
+- lib/mcp_on_ruby/registry.rb
+- lib/mcp_on_ruby/result.rb
+- lib/mcp_on_ruby/rspec.rb
+- lib/mcp_on_ruby/schema.rb
+- lib/mcp_on_ruby/server_factory.rb
+- lib/mcp_on_ruby/stdio.rb
+- lib/mcp_on_ruby/test_helper.rb
+- lib/mcp_on_ruby/tool_spec.rb
+- lib/mcp_on_ruby/tool_table.rb
 - lib/mcp_on_ruby/version.rb
-homepage: https://github.com/rubyonai/mcp_on_ruby
+- lib/mcp_on_ruby/warden_hook.rb
+- lib/tasks/mcp_on_ruby.rake
+homepage: https://github.com/nagstler/mcp_on_ruby
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/rubyonai/mcp_on_ruby
-  source_code_uri: https://github.com/rubyonai/mcp_on_ruby
-  changelog_uri: https://github.com/rubyonai/mcp_on_ruby/blob/main/CHANGELOG.md
+  source_code_uri: https://github.com/nagstler/mcp_on_ruby/tree/main
+  changelog_uri: https://github.com/nagstler/mcp_on_ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/nagstler/mcp_on_ruby/issues
+  documentation_uri: https://github.com/nagstler/mcp_on_ruby#readme
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -196,15 +125,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Production-ready MCP server for Rails applications
+summary: Make your Rails app usable by AI agents.
 test_files: []

data/CODE_OF_CONDUCT.md

@@ -1,56 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior:
-
-* The use of sexualized language or imagery, and sexual attention or advances
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information without explicit permission
-* Other conduct which could reasonably be considered inappropriate
-
-## Enforcement Responsibilities
-
-Project maintainers are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[INSERT EMAIL ADDRESS].
-
-All complaints will be reviewed and investigated promptly and fairly.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.0, available at
-https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
-
-[homepage]: https://www.contributor-covenant.org

data/CONTRIBUTING.md

@@ -1,86 +0,0 @@
-# Contributing to MCP on Ruby
-
-We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
-
-- Reporting a bug
-- Discussing the current state of the code
-- Submitting a fix
-- Proposing new features
-- Becoming a maintainer
-
-## Development Process
-
-We use GitHub to host code, to track issues and feature requests, as well as accept pull requests.
-
-## Pull Requests
-
-1. Fork the repo and create your branch from `main`.
-2. If you've added code that should be tested, add tests.
-3. If you've changed APIs, update the documentation.
-4. Ensure the test suite passes.
-5. Make sure your code lints.
-6. Issue that pull request!
-
-## Development Setup
-
-```bash
-# Clone your fork
-git clone https://github.com/nagstler/mcp_on_ruby.git
-cd mcp_on_ruby
-
-# Install dependencies
-bundle install
-
-# Run the generators to test Rails integration
-mkdir test_app && cd test_app
-rails new . --skip-git
-echo "gem 'mcp_on_ruby', path: '..' " >> Gemfile
-bundle install
-rails generate mcp_on_ruby:install
-
-# Test the gem
-cd .. && ruby -e "require './lib/mcp_on_ruby'; puts 'Gem loads successfully'"
-```
-
-## Code Style
-
-- Follow standard Ruby conventions
-- Use meaningful variable and method names
-- Add documentation for public APIs
-- Keep methods focused and small
-
-## Testing
-
-Currently, we use manual testing and examples. In the future, we plan to add:
-- RSpec test suite
-- Integration tests with Rails
-- CI/CD pipeline
-
-## Bug Reports
-
-We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/nagstler/mcp_on_ruby/issues).
-
-**Great Bug Reports** tend to have:
-
-- A quick summary and/or background
-- Steps to reproduce
-  - Be specific!
-  - Give sample code if you can
-- What you expected would happen
-- What actually happens
-- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
-
-## Feature Requests
-
-We use GitHub issues to track feature requests. Propose a feature by [opening a new issue](https://github.com/nagstler/mcp_on_ruby/issues).
-
-**Great Feature Requests** include:
-
-- Clear use case description
-- Why this feature would be useful
-- Proposed API or implementation approach
-- Examples of how it would be used
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the same MIT License that covers the project.

data/bin/console

@@ -1,11 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "mcp_on_ruby"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-require "irb"
-IRB.start(__FILE__)

data/bin/setup

@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install