ask-rails-mcp 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0735b5cd8de91ba218011330ce945aaf843cb2b84d1a98e382b54cbe3f7ef51f
-  data.tar.gz: 6cec7455ddc917a6b3482fe5cb9e72c2ffefd168f3f1310b93fbf6570ad0ece3
+  metadata.gz: 773a252d6ae9d0d904684e3596629d581ae895d6f8d93f350e6454b9a2b55d6f
+  data.tar.gz: e8a5b894f4fc6df93fe4354c6eb4f387e5a855e018533189e5776f8cc14b32a0
 SHA512:
-  metadata.gz: 972281e304211d8939710ef5c6167313fcd0945b7d30204642d5be58f6c8f7c4f41fc3ea1159d4c04cb013059ad7b803fe455d086175e5383327e90709a1f970
-  data.tar.gz: 61f31bccee0eb59227266ea2e23637fe4b5f616db9d4a6d40d6b2df56c3251a951e8c31294503ba5b3209e8c59635a78c897852b125c93046371ef1a831ab24e
+  metadata.gz: e2231837d2de97ad7b4e872238d9afb76a7eaf0d586040b8d3cfe3e3eaa50bfeaf6856618540b2ef8c07bc154ad667800e60afb0d3a761c154758159ae66164e
+  data.tar.gz: 64ae6358166ea51a76203be254be5dc2f155b0151fda344bf305edcb84c7b8094b2912f814bfbf6c9bb7db45812143eb0c49d8fd52016a767e5ceadcaeb83aa3

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.2.0] — 2026-07-23
+
+### Added
+
+- **stdio transport** — `Ask::Rails::MCP.start` boots the Rails app and starts a stdio MCP server. Run `ask-rails-mcp` from your Rails app root.
+- **`bin/ask-rails-mcp`** — CLI entry point for local development. No web server needed.
+
 ## [0.1.0] — 2026-07-23
 
 ### Added

data/README.md

@@ -12,6 +12,33 @@ bundle add ask-rails-mcp
 
 ## Usage
 
+### Option 1: stdio (local development — recommended)
+
+Run from your Rails app root:
+
+```bash
+cd my-rails-app
+ask-rails-mcp
+```
+
+This boots your Rails app and starts an MCP stdio server. Configure in `~/.zcode/cli/config.json` (or your agent's MCP config):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "ask-rails-mcp": {
+        "type": "stdio",
+        "command": "ask-rails-mcp",
+        "args": []
+      }
+    }
+  }
+}
+```
+
+### Option 2: HTTP endpoint (remote/production)
+
 Mount in `config/routes.rb` behind your existing auth:
 
 ```ruby
@@ -22,14 +49,14 @@ Rails.application.routes.draw do
 end
 ```
 
-Then configure any MCP-compatible agent to connect to your app. For example, in Claude Code's `~/.claude/settings.json`:
+Then configure any MCP-compatible agent:
 
 ```json
 {
   "mcp": {
     "servers": {
       "ask-rails-mcp": {
-        "type": "url",
+        "type": "http",
         "url": "https://myapp.com/ask/mcp"
       }
     }

data/bin/ask-rails-mcp

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "ask-rails-mcp"
+
+Ask::Rails::MCP.start

data/lib/ask/rails/mcp/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module Rails
     module MCP
-      VERSION = "0.1.0"
+      VERSION = "0.2.0"
     end
   end
 end

data/lib/ask/rails/mcp.rb

@@ -82,6 +82,34 @@ module Ask
           success_response(id, result)
         end
 
+        # Start the MCP stdio server, auto-loading the Rails app.
+        #
+        #   $ ask-rails-mcp
+        #
+        # The server will listen for JSON-RPC messages on stdin and write
+        # responses to stdout — the standard MCP stdio transport. Register
+        # this executable as an MCP server in your client configuration:
+        #
+        #   "mcp": {
+        #     "servers": {
+        #       "ask-rails-mcp": {
+        #         "type": "stdio",
+        #         "command": "ask-rails-mcp",
+        #         "args": []
+        #       }
+        #     }
+        #   }
+        def start
+          load_rails_app
+
+          Ask::MCP::Server.start_stdio(
+            name: "ask-rails-mcp",
+            tools: tools,
+            capabilities: { tools: {} },
+            debug: ENV["DEBUG"] == "1"
+          )
+        end
+
         # Get or clear the cache (useful in tests).
         def reset!
           @tools = nil
@@ -91,6 +119,14 @@ module Ask
 
         private
 
+        def load_rails_app
+          return if defined?(::Rails) && ::Rails.application
+          require File.expand_path("config/environment")
+        rescue LoadError
+          warn "ask-rails-mcp: must be run from your Rails app root (config/environment.rb not found)"
+          exit 1
+        end
+
         def success_response(id, result)
           { "jsonrpc" => "2.0", "id" => id, "result" => deep_stringify_keys(result) }
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-rails-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -100,12 +100,14 @@ description: |
   connect to inspect your schema, query your database, read models, and more.
 email:
 - kaka@myrrlabs.com
-executables: []
+executables:
+- ask-rails-mcp
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - README.md
+- bin/ask-rails-mcp
 - lib/ask-rails-mcp.rb
 - lib/ask/rails/mcp.rb
 - lib/ask/rails/mcp/version.rb