curateMCP

Intelligent routing for MCP tools - Core engine and API

GitHubスター

0

ユーザー評価

未評価

お気に入り

0

閲覧数

6

フォーク

0

イシュー

0

README
The Problem

AI agents are incredible but choosing the right tool is still manual:

  • 5000+ MCP servers exist but which one should ChatGPT use for booking restaurants?
  • Agents guess wrong 40% of the time, leading to failed automation
  • Developers spend hours manually mapping capabilities to tools
The Solution

curateMCP provides intelligent routing that automatically selects and combines the best MCP tools:

from curateMCP import MCPRouter

router = MCPRouter()

# Instead of manually choosing between 15 restaurant booking tools
result = await router.route(
    request="Book Italian dinner tomorrow 7pm for 4 people",
    context={"location": "NYC", "budget": "mid-range"}
)

# → Automatically selects best tool, handles auth, returns reservation
Quick Start
Installation
bashpip install curateMCP-core

# or

npm install @curateMCP/core

Basic Usage
pythonimport asyncio
from curateMCP import MCPRouter

async def main():
    router = MCPRouter()
    
    # Simple routing
    result = await router.route("Send email to john@example.com")
    print(f"Selected MCP: {result.selected_mcp}")
    
    # Advanced routing with context
    result = await router.route(
        request="Create expense report from last week's receipts",
        context={
            "user_id": "user_123",
            "integrations": ["expensify", "quickbooks"],
            "date_range": "2025-06-30:2025-07-06"
        }
    )

if __name__ == "__main__":
    asyncio.run(main())

Self-Hosted Setup

bash# Clone and run locally

git clone https://github.com/YOURUSERNAME/curateMCP-core

cd curateMCP-core

docker-compose up -d

# Test the API
curl localhost:8080/health
How It Works

Capability Discovery - Analyzes MCP servers to understand what they can do
Intelligent Matching - Uses ML to match user requests to appropriate tools
Smart Composition - Chains multiple MCPs together for complex tasks
Performance Learning - Gets smarter based on success/failure feedback

Features

🎯 Intelligent Routing - ML-powered tool selection
⚡ Sub-100ms Response - Optimized for real-time usage
🔗 Composition Engine - Automatically chains multiple tools
📊 Performance Tracking - Success rates and optimization
🛡️ Security First - Capability verification and sandboxing
🌐 Multi-Language - Python, JavaScript, Go, Rust SDKs

Examples

AI Chatbot Integration - Add curateMCP to your AI assistant
Workflow Automation - Build complex multi-step automations
Enterprise Setup - Production deployment guide
Custom Routing - Build domain-specific routers

Coming soon: Complete examples directory
Documentation

📖 Getting Started Guide
🔧 API Reference
🏗️ Architecture Overview

Community & Support

💬 Discussions - Get help and discuss features
🐛 Issue Tracker - Report bugs
💡 Feature Requests - Suggest improvements
📧 Security Issues - Report vulnerabilities privately

Contributing
We love contributions! See our Contributing Guide for details.
Quick Contributing Steps

Fork the repo
Create a feature branch: git checkout -b amazing-feature
Make your changes and add tests
Ensure CI passes: pytest
Submit a pull request

Roadmap

 Q2 2025 - Core routing engine
 Q3 2025 - ML-powered matching
 Q4 2025 - Advanced composition engine
 Q1 2026 - Enterprise security features
 Q2 2026 - Multi-modal routing (text, images, files)

License
MIT License - see LICENSE for details.
Acknowledgments

Anthropic for creating the MCP standard
MCP Registry for the foundational infrastructure
Our amazing contributors