scopweb/mcp-context-rust

🦀 MCP Context Rust

A multi-language Model Context Protocol (MCP) server written in Rust that provides intelligent context analysis and code pattern training for AI assistants. Supports Rust, Node.js, Python, Go, Java, PHP, and .NET projects.

⚠️ Experimental Project

This is a proof-of-concept MCP server focused on context reinforcement and learning experiments for Claude Desktop.

Intended for research and development purposes only. This project explores advanced context management patterns and training mechanisms for AI assistants. Use it as a reference for improving future MCP implementations or adapting the concepts to your own projects.

🧪 Not recommended for production use. Consider this an educational resource and testing ground for MCP capabilities.

📊 Honest Assessment: | 🛣️ Future Plans:

✨ Features

Core Functionality

• 🌐 Multi-Language Support: Analyze projects in 7+ languages
  • Rust (Cargo.toml) - actix-web, axum, tokio
  • Node.js (package.json) - React, Vue, Next.js, Express, Svelte
  • Python (pyproject.toml) - Django, Flask, FastAPI
  • Go (go.mod) - Gin, Fiber
  • Java (pom.xml) - Spring, Gradle
  • PHP (composer.json) - Laravel, Symfony, WordPress
  • .NET (.csproj) - Blazor, ASP.NET Core
• 🔍 Deep Code Analysis: Parse project files, analyze code with tree-sitter, detect dependencies
• 📚 60+ Built-in Patterns: Best practices for various development scenarios
  • 🔄 Lifecycle (6 patterns)
  • ⚡ Performance (5 patterns)
  • 🌐 JavaScript Interop (4 patterns)
  • 📡 Data & APIs (4 patterns)
  • 🔒 Security (4 patterns)
  • 💉 Dependency Injection (2 patterns)
  • 📦 State Management (2 patterns)
• 🎓 Pattern Training: Incremental learning system - add your own patterns
• 🎯 Context-Aware: Intelligent suggestions based on project analysis
• 🦀 Rust Performance: 10x faster than Python equivalents
• 🔌 MCP Native: Works with Claude Desktop and other MCP clients

Security & Quality

• 🔒 Automated Security Scanning: cargo-audit integration with RustSec Database (861 advisories)
• ✅ Zero Known Vulnerabilities: 159 dependencies verified, 0 issues found
• 🔍 Unsafe Code Detection: cargo-geiger monitoring in CI/CD
• 📋 Continuous Integration: GitHub Actions workflow with security, lint, format, and test checks
• 📊 Code Quality: Enforced formatting (cargo fmt) and linting (cargo clippy)

🦀 Why Rust?

• ⚡ 10x Faster than Python implementations
• 🔒 Memory Safe - zero crashes or leaks
• 📦 Single Binary - no runtime dependencies
• 🚀 Concurrent - efficient async request handling
• 🎯 Native Parsing - tree-sitter integration

🚀 Quick Start

Prerequisites

• Rust 1.70+ (Install Rust)

Installation

# Clone the repository
git clone https://github.com/scopweb/mcp-context-rust.git
cd mcp-context-rust

# Build release binary
cargo build --release

# Binary location:
# Windows: target/release/mcp-context-rust.exe
# Linux/Mac: target/release/mcp-context-rust

Configuration for Claude Desktop

Windows

Edit: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "context-rust": {
      "command": "C:\\path\\to\\mcp-context-rust\\target\\release\\mcp-context-rust.exe",
      "args": [],
      "env": {
        "MCP_PATTERNS_PATH": "C:\\path\\to\\mcp-context-rust\\data\\patterns"
      }
    }
  }
}

Linux/Mac

Edit: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "context-rust": {
      "command": "/path/to/mcp-context-rust/target/release/mcp-context-rust",
      "args": [],
      "env": {
        "MCP_PATTERNS_PATH": "/path/to/mcp-context-rust/data/patterns"
      }
    }
  }
}

Important: Use absolute paths in the configuration.

Restart Claude Desktop

Close and reopen Claude Desktop to load the MCP server.

📖 Usage

Analyze a Project

You: Analyze my project at C:\Projects\MyLaravelApp

Claude → calls analyze-project tool
Server → detects PHP/Laravel, parses composer.json, finds Vue frontend
Claude → shows structure, dependencies, framework-specific suggestions

Supported projects:

• Rust, Node.js, Python, Go, Java, PHP, .NET
• Auto-detects framework (Laravel, React, Django, Spring, etc.)

Get Code Patterns

You: Show me lifecycle patterns

Claude → calls get-patterns tool
Server → returns relevant patterns with code examples
Claude → explains best practices

Search Patterns

You: Find patterns for async initialization

Claude → calls search-patterns tool
Server → intelligent search with scoring
Claude → shows most relevant patterns

Train New Patterns

You: Save this as a best practice for error handling:
[your code example]

Claude → calls train-pattern tool
Server → stores pattern with metadata
Claude → confirms pattern saved

Get Statistics

You: Show pattern database stats

Claude → calls get-statistics tool
Server → returns total patterns, categories, frameworks

🛠️ Available Tools

🏗️ Architecture

mcp-context-rust/
├── src/
│   ├── main.rs              # Entry point
│   ├── lib.rs               # Library root
│   ├── config.rs            # Configuration
│   ├── types.rs             # Shared types (Project, Dependency, etc.)
│   ├── analyzer/
│   │   ├── mod.rs           # Analyzer module
│   │   ├── detector.rs      # Project type detection
│   │   ├── generic.rs       # Multi-language analyzer
│   │   ├── project.rs       # Legacy .NET analyzer
│   │   └── csharp.rs        # C# tree-sitter parser
│   ├── context/             # Context generation
│   ├── training/            # Pattern management
│   │   └── mod.rs           # Training system
│   └── mcp/                 # MCP protocol
│       └── mod.rs           # Server implementation
├── data/
│   └── patterns/            # Built-in patterns (JSON)
├── tests/                   # Integration tests
├── docs/                    # Technical documentation
├── Cargo.toml
├── README.md
├── CHANGELOG.md
└── LICENSE

🧪 Testing

# Run all tests
cargo test

# Run specific test module
cargo test analyzer

# Test with output
cargo test -- --nocapture

# Manual test (stdio)
echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}' | cargo run --release

📚 Documentation

Setup & Usage

• (ES) / - Detailed configuration instructions
• (ES) / - Practical examples and scenarios

Development

• - Project architecture and development workflow
• - Complete guide to building MCP servers
• - All 27+ built-in patterns
• - Version history

Project Status & Planning

• - Does this actually save time? (Truthful evaluation)
• - From PoC to production-ready tool
• - How cargo-audit works and continuous scanning
• - Latest audit results: 0 vulnerabilities ✅

🔒 Security Status

This project implements comprehensive security scanning:

✅ Automated dependency scanning with cargo-audit
✅ 159 dependencies verified against 861 RustSec advisories
✅ Zero known vulnerabilities found
✅ Continuous monitoring on every push (GitHub Actions)
✅ Daily security checks (2 AM UTC)
✅ Unsafe code detection with cargo-geiger
✅ Code quality enforcement (clippy, fmt)
✅ Comprehensive CI/CD pipeline

See for detailed results.

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Adding Patterns

To contribute new patterns:

1. Add JSON file to data/patterns/
2. Follow the pattern schema
3. Test with get-statistics tool
4. Submit PR with pattern details

📝 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Built with Rust 🦀
• Code parsing with tree-sitter
• MCP Protocol by Anthropic

🐛 Troubleshooting

Server not connecting

1. Check Claude Desktop logs: %APPDATA%\Claude\logs\mcp-server-context-rust.log
2. Verify executable path is absolute
3. Ensure MCP_PATTERNS_PATH points to correct directory
4. Try rebuilding: cargo clean && cargo build --release

No patterns loaded

# Check patterns directory exists
ls data/patterns/*.json

# Verify environment variable
echo $MCP_PATTERNS_PATH  # Linux/Mac
echo %MCP_PATTERNS_PATH%  # Windows

Parse errors

• Check files are UTF-8 encoded
• Verify project structure is correct

For more help, see or open an issue.

📬 Contact

• Issues: GitHub Issues
• Discussions: GitHub Discussions