mcp-on-rails 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9de4dca8095e1020e24bf8f70df4a28f148b2cc85ecf2768a556722da1292132
-  data.tar.gz: c553494738ae79d5ac4409021a2f1ddd69caf1506e47d38c42e93add47c9f106
+  metadata.gz: d38b6e8a0b24122cb1ca1ad3c859af9ae356fea7ab33b632495c759cfc20e4e2
+  data.tar.gz: 0420f862f57d72c1a6b176d632e2e50a34e2522961955556413d188eba160b19
 SHA512:
-  metadata.gz: cca8f6b8ebcdfe8ff07e50af3008d0aa50208225b127d5edddc3cb7b86b03329dcd36ae897ff079d387e2b4c7ef104932a6e5dca22b1e7da8380d029fc768ed7
-  data.tar.gz: 7c120a4dff702bdb99be86fea3d02e02f0832bdae3e9b008a9397510a4ff7b4cff1f33319e0f038401caa007681a9f7e322c84c27e77f4b6dce4d5a1ce27a4d7
+  metadata.gz: 1b15d938050f2873ab2c20289a59fe0e482011edaa1952d45b09b913328f4ef4dc064af44c6ac2883b1edac204b7a66eeea28cc29ee650a43248fa1cbd3bb709
+  data.tar.gz: e16377c3075cff343636a69c224af02ec40c55a593c8f2e768e74d8793d6f8221c18b6c3198d39f070e80cbde5e81a7bb1cd944b14a8728eeedbf2ad8066b3d4

data/README.md

@@ -80,20 +80,35 @@ your-rails-project/
     └── mcp-setup          # Project setup script
 ```
 
-## MCP Client Configuration
+## Using with AI Assistants
 
-### VS Code with GitHub Copilot
+### GitHub Copilot (VS Code)
 
-1. Install the MCP extension for VS Code
-2. Configure your workspace settings:
+GitHub Copilot doesn't directly read MCP configuration files, but you can leverage the specialized prompts by:
 
-```json
-{
-  "mcp.configPath": ".mcp-on-rails/mcp-config.yml"
-}
-```
+1. **Reference prompts in your requests**:
+   ```
+   "Please check .mcp-on-rails/prompts/models.md for Rails model best practices and help me with this ActiveRecord model"
+   ```
+
+2. **Use context-aware requests**:
+   ```
+   "Looking at .mcp-on-rails/prompts/controllers.md, help me implement this API endpoint"
+   ```
+
+3. **Add to VS Code workspace settings** (optional):
+   ```json
+   {
+     "files.associations": {
+       ".mcp-on-rails/**/*.md": "markdown"
+     },
+     "explorer.fileNesting.patterns": {
+       ".mcp-on-rails": "mcp-config.yml,context.md"
+     }
+   }
+   ```
 
-### Claude Desktop
+### Claude Desktop (Native MCP Support)
 
 Add to your Claude Desktop configuration:
 
@@ -110,9 +125,13 @@ Add to your Claude Desktop configuration:
 }
 ```
 
-### Other MCP Clients
+### Other AI Assistants
 
-The generated `mcp-config.yml` is compatible with most MCP clients. Refer to your client's documentation for specific configuration steps.
+For any AI assistant, you can reference the specialized prompts manually:
+- **Models**: "Use .mcp-on-rails/prompts/models.md as context"
+- **Controllers**: "Reference .mcp-on-rails/prompts/controllers.md"
+- **Views**: "Check .mcp-on-rails/prompts/views.md for guidance"
+- **Tests**: "Follow .mcp-on-rails/prompts/tests.md best practices"
 
 ## Context Areas
 

data/lib/mcp/on/rails/generator.rb

@@ -6,6 +6,8 @@ require "fileutils"
 module Mcp
   module On
     module Rails
+      # Generator class for creating MCP configuration files and directories
+      # Handles project setup with templates and customization
       class Generator
         attr_reader :project_name, :project_path
 
@@ -19,9 +21,11 @@ module Mcp
           copy_prompts
           generate_config_file
           copy_context_file
+          create_copilot_instructions
           create_executable
           puts "✅ MCP on Rails setup completed for '#{project_name}'"
-          puts "📁 Files created in: #{File.join(project_path, '.mcp-on-rails')}"
+          puts "📁 Files created in: #{File.join(project_path, ".mcp-on-rails")}"
+          puts "📋 GitHub Copilot instructions: #{File.join(project_path, ".github/copilot-instructions.md")}"
           puts "🚀 Run: ./bin/mcp-setup to configure your project"
         end
 
@@ -41,10 +45,10 @@ module Mcp
         def generate_config_file
           template_file = File.join(templates_path, "mcp-config.yml.erb")
           target_file = File.join(project_path, ".mcp-on-rails", "mcp-config.yml")
-          
+
           template = ERB.new(File.read(template_file))
           content = template.result(binding)
-          
+
           File.write(target_file, content)
         end
 
@@ -54,14 +58,30 @@ module Mcp
           FileUtils.cp(source_file, target_file)
         end
 
+        def create_copilot_instructions
+          github_dir = File.join(project_path, ".github")
+          FileUtils.mkdir_p(github_dir)
+
+          source_file = File.join(templates_path, "copilot-instructions.md")
+          target_file = File.join(github_dir, "copilot-instructions.md")
+          FileUtils.cp(source_file, target_file)
+        end
+
         def create_executable
           bin_dir = File.join(project_path, "bin")
           FileUtils.mkdir_p(bin_dir)
-          
-          executable_content = <<~SCRIPT
+
+          executable_content = build_executable_content
+          executable_path = File.join(bin_dir, "mcp-setup")
+          File.write(executable_path, executable_content)
+          FileUtils.chmod(0o755, executable_path)
+        end
+
+        def build_executable_content
+          <<~SCRIPT
             #!/usr/bin/env ruby
             # frozen_string_literal: true
-            
+
             puts "🔧 Setting up MCP on Rails for #{project_name}"
             puts "📋 Configuration files are ready in .mcp-on-rails/"
             puts ""
@@ -70,10 +90,6 @@ module Mcp
             puts "2. Use the prompts in .mcp-on-rails/prompts/ for context-aware AI assistance"
             puts "3. Customize the configuration as needed for your project"
           SCRIPT
-          
-          executable_path = File.join(bin_dir, "mcp-setup")
-          File.write(executable_path, executable_content)
-          FileUtils.chmod(0o755, executable_path)
         end
 
         def templates_path

data/lib/mcp/on/rails/templates/copilot-instructions.md

@@ -0,0 +1,177 @@
+# GitHub Copilot Instructions for MCP on Rails
+
+You are working with a Rails project that has been configured with MCP on Rails, providing specialized AI assistance for Rails development. This project follows the principles of claude-on-rails but is adapted for GitHub Copilot usage.
+
+## Project Context
+
+This Rails project uses **MCP on Rails** configuration located in `.mcp-on-rails/` directory. Always reference the specialized prompts and context when helping with development tasks.
+
+### Key Directories and Their Purpose:
+- **`.mcp-on-rails/prompts/`** - Contains specialized prompts for different Rails components
+- **`.mcp-on-rails/context.md`** - Project-specific context and information
+- **`.mcp-on-rails/mcp-config.yml`** - MCP server configuration
+
+## Specialized Agent Roles
+
+When working on different parts of the Rails application, adopt the appropriate specialist role and reference the corresponding prompt file:
+
+### 🏗️ **Architect Role** (Overall coordination)
+**When to use**: Project-wide decisions, architecture planning, feature coordination
+**Reference**: `.mcp-on-rails/prompts/architect.md`
+**Focus**: 
+- Coordinate implementation across multiple components
+- Make high-level architectural decisions
+- Ensure consistency across the application
+- Plan complex features that span multiple areas
+
+### 🗄️ **Models Specialist** (Data layer)
+**When working in**: `app/models/`, `db/migrate/`, database-related tasks
+**Reference**: `.mcp-on-rails/prompts/models.md`
+**Focus**:
+- ActiveRecord models, associations, validations
+- Database migrations and schema design
+- Query optimization and performance
+- Data integrity and constraints
+
+### 🎮 **Controllers Specialist** (HTTP handling)
+**When working in**: `app/controllers/`, routing, APIs
+**Reference**: `.mcp-on-rails/prompts/controllers.md`
+**Focus**:
+- RESTful controllers and routing
+- Authentication and authorization
+- API design and implementation
+- Request/response handling
+
+### 🎨 **Views Specialist** (Frontend/UI)
+**When working in**: `app/views/`, `app/assets/`, frontend components
+**Reference**: `.mcp-on-rails/prompts/views.md`
+**Focus**:
+- ERB templates and layouts
+- HTML/CSS styling and responsive design
+- Asset pipeline management
+- UI components and partials
+
+### ⚡ **Stimulus Specialist** (JavaScript/Interactivity)
+**When working in**: `app/javascript/`, Stimulus controllers, Turbo features
+**Reference**: `.mcp-on-rails/prompts/stimulus.md`
+**Focus**:
+- Stimulus.js controllers and targets
+- Turbo Drive, Frames, and Streams
+- JavaScript behavior and DOM manipulation
+- Progressive enhancement
+
+### 🔧 **Jobs Specialist** (Background processing)
+**When working in**: `app/jobs/`, background tasks, queues
+**Reference**: `.mcp-on-rails/prompts/jobs.md`
+**Focus**:
+- ActiveJob background processing
+- Queue management and scheduling
+- Async task implementation
+- Performance optimization for background work
+
+### 🧪 **Tests Specialist** (Quality assurance)
+**When working in**: `test/`, `spec/`, testing-related tasks
+**Reference**: `.mcp-on-rails/prompts/tests.md`
+**Focus**:
+- Comprehensive test coverage
+- Test-driven development (TDD)
+- Factory and fixture management
+- Integration and system tests
+
+### 🚀 **DevOps Specialist** (Infrastructure/Deployment)
+**When working in**: `config/`, deployment, infrastructure
+**Reference**: `.mcp-on-rails/prompts/devops.md`
+**Focus**:
+- Application configuration and environments
+- Docker, CI/CD, and deployment strategies
+- Performance monitoring and optimization
+- Security and infrastructure concerns
+
+## How to Work with This Project
+
+### 1. **Always Check Context First**
+Before starting any task, review:
+```
+- .mcp-on-rails/context.md for project-specific information
+- .mcp-on-rails/prompts/[relevant-area].md for specialized guidance
+```
+
+### 2. **Multi-Agent Coordination**
+For complex features that span multiple areas:
+1. Start with the **Architect** role to plan the implementation
+2. Break down tasks for appropriate specialists
+3. Ensure consistency across all components
+4. Always include comprehensive tests
+
+### 3. **Rails Best Practices**
+Always follow:
+- Rails conventions and naming patterns
+- RESTful design principles
+- Security best practices
+- Performance optimization
+- Comprehensive test coverage
+
+### 4. **Code Quality Standards**
+- Write clean, readable, and maintainable code
+- Follow Ruby and Rails style guides
+- Include proper documentation and comments
+- Implement error handling and edge cases
+- Consider performance implications
+
+## Implementation Workflow
+
+### For New Features:
+1. **Plan** (Architect): Understand requirements and design approach
+2. **Model** (Models): Design data structure and relationships
+3. **Route & Control** (Controllers): Implement HTTP endpoints
+4. **Present** (Views): Create user interface
+5. **Enhance** (Stimulus): Add interactive behavior
+6. **Process** (Jobs): Handle background tasks if needed
+7. **Test** (Tests): Ensure comprehensive coverage
+8. **Deploy** (DevOps): Configure for production
+
+### For Bug Fixes:
+1. **Diagnose**: Identify the problem area
+2. **Reference**: Check relevant specialist prompt
+3. **Fix**: Implement solution following best practices
+4. **Test**: Verify fix with appropriate tests
+5. **Document**: Update relevant documentation
+
+### For Refactoring:
+1. **Analyze**: Understand current implementation
+2. **Plan**: Design improved approach
+3. **Refactor**: Implement changes systematically
+4. **Test**: Ensure no regression
+5. **Optimize**: Improve performance where applicable
+
+## Special Considerations
+
+### Security First
+- Always validate user input
+- Implement proper authentication/authorization
+- Follow Rails security guidelines
+- Use strong parameters and CSRF protection
+
+### Performance Matters
+- Optimize database queries (avoid N+1)
+- Use appropriate caching strategies
+- Monitor and profile performance
+- Consider background processing for heavy tasks
+
+### Test Everything
+- Write tests before implementing features (TDD)
+- Ensure high test coverage
+- Include integration and system tests
+- Test edge cases and error conditions
+
+## Quick Reference Commands
+
+When asked to help with Rails development:
+
+1. **Identify the area** of work (models, controllers, views, etc.)
+2. **Reference the appropriate prompt**: "Let me check .mcp-on-rails/prompts/[area].md for best practices"
+3. **Apply specialist knowledge** for that area
+4. **Consider dependencies** and coordination with other areas
+5. **Ensure comprehensive testing** and documentation
+
+Remember: You are part of a coordinated development team. Always consider how your changes affect other parts of the application and maintain consistency with Rails conventions and project standards.

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

@@ -3,7 +3,7 @@
 module Mcp
   module On
     module Rails
-      VERSION = "0.1.0"
+      VERSION = "0.2.0"
     end
   end
 end

data/lib/mcp/on/rails.rb

@@ -5,6 +5,8 @@ require_relative "rails/generator"
 
 module Mcp
   module On
+    # Main module for MCP on Rails gem
+    # Provides setup functionality for Rails projects with MCP configuration
     module Rails
       class Error < StandardError; end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mcp-on-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - GoCoder
@@ -27,6 +27,7 @@ files:
 - lib/mcp/on/rails.rb
 - lib/mcp/on/rails/generator.rb
 - lib/mcp/on/rails/templates/context.md
+- lib/mcp/on/rails/templates/copilot-instructions.md
 - lib/mcp/on/rails/templates/mcp-config.yml.erb
 - lib/mcp/on/rails/templates/prompts/api.md
 - lib/mcp/on/rails/templates/prompts/architect.md