mcp_on_ruby 0.3.0 → 2.0.0

data/lib/mcp_on_ruby/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module McpOnRuby
+  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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "mcp"
+require "active_support"
+require "active_support/core_ext"
+require "mcp_on_ruby/version"
+
+# MCP on Ruby exposes Rails controller actions as Model Context Protocol tools.
+module McpOnRuby
+  class Error < StandardError; end
+
+  # Raised when tool declarations cannot be served, for example a typo in an action name.
+  class ConfigurationError < Error; end
+
+  # Rack env key set on requests dispatched by an MCP tool call; holds the tool name.
+  TOOL_ENV_KEY = "mcp_on_ruby.tool"
+
+  # Rack env key holding the user a local (stdio) session acts as.
+  USER_ENV_KEY = "mcp_on_ruby.user"
+
+  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 << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # The tools exposed by the running application.
+    def registry
+      @registry ||= Registry.new
+    end
+
+    # Builds MCP servers for HTTP requests and stdio sessions.
+    def server_factory
+      @server_factory ||= ServerFactory.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    # Restores the default configuration. Intended for tests.
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end
+
+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,256 +1,79 @@
 --- !ruby/object:Gem::Specification
 name: mcp_on_ruby
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Nagendra Dhanakeerthi
 autorequire:
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 2026-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: concurrent-ruby
+  name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-- !ruby/object:Gem::Dependency
-  name: dry-schema
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.13'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.13'
-- !ruby/object:Gem::Dependency
-  name: faraday
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: '9'
 - !ruby/object:Gem::Dependency
-  name: faraday-net_http
+  name: mcp
   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: jwt
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '1.8'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: 1.8.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: rack
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '1.8'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: 1.8.2
 - !ruby/object:Gem::Dependency
-  name: rack-cors
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: webrick
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.7'
-- !ruby/object:Gem::Dependency
-  name: redis
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: activerecord
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.4'
-- !ruby/object:Gem::Dependency
-  name: codecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.0
-- !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:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.21.2
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.21.2
-- !ruby/object:Gem::Dependency
-  name: simplecov-cobertura
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.1'
-- !ruby/object:Gem::Dependency
-  name: vcr
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
-- !ruby/object:Gem::Dependency
-  name: webmock
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.18'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.1'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '3.18'
-description: |-
-  A comprehensive Ruby gem for implementing Model Context Protocol servers
-  to standardize interactions with AI language models
+        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: []
@@ -258,46 +81,41 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
-- lib/ruby_mcp.rb
-- lib/ruby_mcp/client.rb
-- lib/ruby_mcp/configuration.rb
-- lib/ruby_mcp/errors.rb
-- lib/ruby_mcp/models/context.rb
-- lib/ruby_mcp/models/engine.rb
-- lib/ruby_mcp/models/message.rb
-- lib/ruby_mcp/providers/anthropic.rb
-- lib/ruby_mcp/providers/base.rb
-- lib/ruby_mcp/providers/openai.rb
-- lib/ruby_mcp/schemas.rb
-- lib/ruby_mcp/server/app.rb
-- lib/ruby_mcp/server/base_controller.rb
-- lib/ruby_mcp/server/content_controller.rb
-- lib/ruby_mcp/server/contexts_controller.rb
-- lib/ruby_mcp/server/controller.rb
-- lib/ruby_mcp/server/engines_controller.rb
-- lib/ruby_mcp/server/generate_controller.rb
-- lib/ruby_mcp/server/messages_controller.rb
-- lib/ruby_mcp/server/router.rb
-- lib/ruby_mcp/storage/active_record.rb
-- lib/ruby_mcp/storage/base.rb
-- lib/ruby_mcp/storage/error.rb
-- lib/ruby_mcp/storage/memory.rb
-- lib/ruby_mcp/storage/redis.rb
-- lib/ruby_mcp/storage_factory.rb
-- lib/ruby_mcp/validator.rb
-- lib/ruby_mcp/version.rb
+- 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/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
+- lib/mcp_on_ruby/warden_hook.rb
+- lib/tasks/mcp_on_ruby.rake
 homepage: https://github.com/nagstler/mcp_on_ruby
 licenses:
 - MIT
 metadata:
-  allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/nagstler/mcp_on_ruby
-  source_code_uri: https://github.com/nagstler/mcp_on_ruby
+  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: []
@@ -307,15 +125,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.2
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Ruby implementation of the Model Context Protocol (MCP)
+summary: Make your Rails app usable by AI agents.
 test_files: []

data/CODE_OF_CONDUCT.md

@@ -1,84 +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.
-
-We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders 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.
-
-Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at nagendra.dhanakeerthi@gmail.com. All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of actions.
-
-**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the community.
-
-## 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.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.

data/CONTRIBUTING.md

@@ -1,92 +0,0 @@
-# Contributing to RubyMCP
-
-Thank you for considering contributing to RubyMCP! This document outlines the process for contributing to the project.
-
-## Code of Conduct
-
-This project and everyone participating in it is governed by our [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.
-
-## How Can I Contribute?
-
-### Reporting Bugs
-
-This section guides you through submitting a bug report for RubyMCP.
-
-Before creating bug reports, please check [the issue list](https://github.com/nagstler/mcp_on_ruby/issues) to avoid duplicating an existing report. When you create a bug report, include as many details as possible:
-
-* **Use a clear and descriptive title**
-* **Describe the exact steps to reproduce the bug**
-* **Provide specific examples**
-* **Describe the behavior you observed**
-* **Explain the behavior you expected**
-* **Include screenshots or animated GIFs** if possible
-* **Include details about your configuration and environment**
-
-### Suggesting Enhancements
-
-This section guides you through submitting an enhancement suggestion for RubyMCP.
-
-Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion:
-
-* **Use a clear and descriptive title**
-* **Provide a detailed description of the suggested enhancement**
-* **Explain why this enhancement would be useful**
-* **Specify which version you're using**
-* **Specify the name and version of the OS you're using**
-
-### Pull Requests
-
-* Fill in the required template
-* Follow the Ruby style guide
-* Include tests for new features
-* Document new code based on the rest of the codebase
-* End all files with a newline
-
-## Development Process
-
-### Setting Up Development Environment
-
-```bash
-# Fork and clone the repository
-git clone https://github.com/yourusername/ruby_mcp.git
-cd ruby_mcp
-
-# Install dependencies
-bundle install
-
-# Run tests
-bundle exec rspec
-
-
-### Testing
-
-Write tests for all new features
-Ensure all tests pass before submitting a pull request
-Run the full test suite locally before submission
-
-```bash
-bundle exec rspec
-```
-
-### Style Guidelines
-
-Code should follow the Ruby style guide
-Run RuboCop to check your code style
-
-```bash
-bundle exec rubocop
-```
-
-### Release Process
-
-RubyMCP follows Semantic Versioning.
-
-- MAJOR version for incompatible API changes
-- MINOR version for backward-compatible functionality additions
-- PATCH version for backward-compatible bug fixes
-
-### First-time Contributors
-If you're new to the project, look for issues labeled with good first issue which are ideal starting points for newcomers.
-
-### License
-By contributing to RubyMCP, you agree that your contributions will be licensed under the project's MIT License.