rails_mcp_code_search 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e1c670e94a061746f627ec212078736dca6e7398a6ca1260872eb829ee53d31
-  data.tar.gz: 38cfa6d2f88765590d1db57432e5639637c0f4ef3a4fa075f9e668d54a423bb4
+  metadata.gz: c858fcf548559d7ecbfac6d211a8c5b56e0e060d147a0ad4792d622a7cd04f44
+  data.tar.gz: 15947e6986cbfa2c22c6f7f1010f842b81285627581711bc62085cb4c61210c9
 SHA512:
-  metadata.gz: 4e06c7f98f2bdaca1c3169d48d9753fdd0456ca3cc3e42f1e7951afd36c88dd704e2e00efe2b2ac268650dce37509c4488a9ee5e9039d9a0562e430dae01e845
-  data.tar.gz: 20a0b55ad4f2a8e1498697d3b16941a3361c1165b1e17a6eb1ef15aca82d5cf85f777de415810bf042c847733b7553f2df5911bcd7c6948acff94520db48c942
+  metadata.gz: 1664358410f167994426d8ef6555e081266a4d3ad84f1d924c6820296caa114f0a8a55744781ae6618aefa57ffd738d234e90870f7ce5ec0d4359ccdfbfe9e72
+  data.tar.gz: 03db6c43580f87cbd41c67404d145f1d42efd4eaab854aa51beee07db1253d6078d32a078231ccab3e5cbd301d18da1fef078e9b33d56028428471ea51cae358

data/README.md

@@ -37,23 +37,11 @@
 
 ```sh
 gem install rails_mcp_code_search
+cd your-project
+rails-mcp-code-search --setup
 ```
 
-Requires Ruby 4.0+. The first run downloads the embedding model (~80 MB) to `~/.cache/informers/`.
-
-Add to `~/.claude/settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "code-search": {
-      "command": "rails-mcp-code-search"
-    }
-  }
-}
-```
-
-That's it. Claude Code launches the server automatically when you open a project.
+Requires Ruby 4.0+. Run `--setup` inside each project you want to index. It creates a version-independent wrapper script (`~/.local/bin/`) and a per-project `.mcp.json` that configures Claude Code automatically. The first search downloads the embedding model (~80 MB) to `~/.cache/informers/`.
 
 ## Tools
 

data/exe/rails-mcp-code-search

@@ -2,4 +2,8 @@
 
 require "rails_mcp_code_search"
 
-RailsMcpCodeSearch::Server.start
+if ARGV.include?("--setup")
+  RailsMcpCodeSearch::Setup.run
+else
+  RailsMcpCodeSearch::Server.start
+end

data/lib/rails_mcp_code_search/server.rb

@@ -8,12 +8,33 @@ module RailsMcpCodeSearch
       Tools::StatusTool
     ].freeze
 
+    INSTRUCTIONS = <<~TEXT
+      Use the code-search tools to find code by concept or behavior using natural language.
+      This is semantic search — it finds code by meaning, not by exact string matching.
+
+      When to use search vs Grep:
+      - Use `search` when looking for concepts like "authentication", "payment processing", or "error handling"
+      - Use `Grep` when looking for exact identifiers like a class name, method name, or string literal
+
+      Workflow:
+      1. The index builds automatically in the background when the server starts
+      2. Use `status` to check if indexing is complete
+      3. Use `search` with natural language queries to find relevant code
+      4. Use `reindex` after major code changes, or with full=true to rebuild from scratch
+
+      Tips:
+      - Scores above 0.7 are strong matches, 0.5-0.7 are partial matches
+      - Use `file_pattern` to narrow results (e.g. "app/models/**/*.rb")
+      - Changed files are automatically re-indexed on each search
+    TEXT
+
     def self.start(project_path: Dir.pwd, db_path: nil)
       runtime = Runtime.boot(project_path:, db_path:)
 
       server = ::MCP::Server.new(
         name: "rails-mcp-code-search",
         version: VERSION,
+        instructions: INSTRUCTIONS,
         tools: TOOLS,
         server_context: { runtime: }
       )

data/lib/rails_mcp_code_search/setup.rb

@@ -0,0 +1,101 @@
+require "json"
+require "fileutils"
+
+module RailsMcpCodeSearch
+  module Setup
+    WRAPPER_DIR = File.join(Dir.home, ".local", "bin")
+    WRAPPER_PATH = File.join(WRAPPER_DIR, "rails-mcp-code-search")
+
+    class << self
+      def run
+        puts "Setting up rails-mcp-code-search...\n\n"
+
+        create_wrapper
+        configure_claude_code
+
+        puts "\nDone! Restart Claude Code in this project to start using semantic search."
+      end
+
+      private
+
+      def create_wrapper
+        FileUtils.mkdir_p WRAPPER_DIR
+
+        init_command = detect_ruby_manager
+        wrapper = <<~BASH
+          #!/bin/bash
+          #{init_command}
+
+          # Auto-update once per day
+          UPDATE_STAMP="$HOME/.local/share/rails-mcp-code-search/.last_update_check"
+          UPDATE_INTERVAL=86400
+          mkdir -p "$(dirname "$UPDATE_STAMP")"
+          if [ -f "$UPDATE_STAMP" ]; then
+            last_check=$(cat "$UPDATE_STAMP")
+          else
+            last_check=0
+          fi
+          now=$(date +%s)
+          if [ $((now - last_check)) -gt $UPDATE_INTERVAL ]; then
+            gem install rails_mcp_code_search --no-document >/dev/null 2>&1
+            echo "$now" > "$UPDATE_STAMP"
+          fi
+
+          exec rails-mcp-code-search "$@"
+        BASH
+
+        File.write WRAPPER_PATH, wrapper
+        File.chmod 0o755, WRAPPER_PATH
+        puts "Created wrapper script: #{WRAPPER_PATH}"
+      end
+
+      def detect_ruby_manager
+        if rbenv_path = find_executable("rbenv")
+          "eval \"$(#{rbenv_path} init - bash)\""
+        elsif asdf_path = find_asdf
+          ". #{asdf_path}"
+        elsif chruby_path = find_chruby
+          "source #{chruby_path}\nchruby ruby"
+        else
+          "# System Ruby — no version manager detected"
+        end
+      end
+
+      def find_executable(name)
+        [
+          "/opt/homebrew/bin/#{name}",
+          "/usr/local/bin/#{name}",
+          File.join(Dir.home, ".#{name}", "bin", name)
+        ].find { File.executable?(_1) }
+      end
+
+      def find_asdf
+        path = File.join(Dir.home, ".asdf", "asdf.sh")
+        path if File.exist?(path)
+      end
+
+      def find_chruby
+        [
+          "/opt/homebrew/share/chruby/chruby.sh",
+          "/usr/local/share/chruby/chruby.sh"
+        ].find { File.exist?(_1) }
+      end
+
+      def configure_claude_code
+        mcp_config_path = File.join(Dir.pwd, ".mcp.json")
+
+        config = if File.exist?(mcp_config_path)
+          JSON.parse File.read(mcp_config_path)
+        else
+          {}
+        end
+
+        config["mcpServers"] ||= {}
+        config["mcpServers"]["code-search"] = { "command" => WRAPPER_PATH }
+
+        File.write mcp_config_path, JSON.pretty_generate(config) + "\n"
+        puts "Configured Claude Code: #{mcp_config_path}"
+      end
+    end
+  end
+end

data/lib/rails_mcp_code_search.rb

@@ -9,6 +9,7 @@ module RailsMcpCodeSearch
   autoload :Runtime, "rails_mcp_code_search/runtime"
   autoload :RubyParser, "rails_mcp_code_search/ruby_parser"
   autoload :Server, "rails_mcp_code_search/server"
+  autoload :Setup, "rails_mcp_code_search/setup"
   autoload :SlidingWindowParser, "rails_mcp_code_search/sliding_window_parser"
 
   module Embeddings

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_mcp_code_search
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Daniel Lopez Prat
@@ -152,6 +152,7 @@ files:
 - lib/rails_mcp_code_search/ruby_parser.rb
 - lib/rails_mcp_code_search/runtime.rb
 - lib/rails_mcp_code_search/server.rb
+- lib/rails_mcp_code_search/setup.rb
 - lib/rails_mcp_code_search/sliding_window_parser.rb
 - lib/rails_mcp_code_search/tools/base_tool.rb
 - lib/rails_mcp_code_search/tools/reindex_tool.rb