{"id":36645812,"url":"https://github.com/cyrup-ai/sweetmcp","last_synced_at":"2026-01-12T10:00:16.055Z","repository":{"id":301267901,"uuid":"1008703517","full_name":"cyrup-ai/sweetmcp","owner":"cyrup-ai","description":"A Blazing-fast, Pure-Rust MCP Solution backed by Pingora / Axum ","archived":false,"fork":false,"pushed_at":"2025-07-26T17:01:23.000Z","size":57553,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-26T21:58:11.995Z","etag":null,"topics":["ai","claude","llm","mcp","pingora"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cyrup-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-26T01:06:08.000Z","updated_at":"2025-07-26T17:01:28.000Z","dependencies_parsed_at":"2025-07-26T19:14:50.511Z","dependency_job_id":null,"html_url":"https://github.com/cyrup-ai/sweetmcp","commit_stats":null,"previous_names":["cyrup-ai/sweetmcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cyrup-ai/sweetmcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrup-ai%2Fsweetmcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrup-ai%2Fsweetmcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrup-ai%2Fsweetmcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrup-ai%2Fsweetmcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cyrup-ai","download_url":"https://codeload.github.com/cyrup-ai/sweetmcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cyrup-ai%2Fsweetmcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28337866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T06:09:07.588Z","status":"ssl_error","status_checked_at":"2026-01-12T06:05:18.301Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","llm","mcp","pingora"],"created_at":"2026-01-12T10:00:15.798Z","updated_at":"2026-01-12T10:00:15.995Z","avatar_url":"https://github.com/cyrup-ai.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SweetMCP 🍯\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/sweetmcp.png\" alt=\"SweetMCP\" style=\"max-width: 100%; width: 600px;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eThe ultimate Model Context Protocol integration platform\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003eZero-configuration AI agent infrastructure with enterprise-grade security\u003c/em\u003e\n\u003c/p\u003e\n\n---\n\n## ⚡ One-Line Installation\n\n```bash\ncurl -fsSL https://get.cyrup.ai/install | sh\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e🔍 \u003cstrong\u003eInstallation Details\u003c/strong\u003e\u003c/summary\u003e\n\n**Cross-Platform Support**: Auto-detects OS and architecture\n- **macOS**: Intel + Apple Silicon (Darwin)\n- **Linux**: x86_64 + aarch64 (systemd)  \n- **Windows**: x86_64 + i686 (services)\n\n**What it installs**:\n1. Rust toolchain (if missing)\n2. Clones `git@github.com:cyrup-ai/sweetmcp`\n3. Builds native binaries with Cargo\n4. Generates wildcard SSL certificates (`*.cyrup.{dev,ai,cloud,pro}`)\n5. Configures OS trust stores and DNS resolution\n6. Deploys systemd/launchd services\n7. Starts daemon with proper privileges\n\n**Result**: Production-ready MCP infrastructure in ~60 seconds\n\u003c/details\u003e\n\n---\n\n## 🏗️ Core Architecture\n\nSweetMCP provides six foundational AI infrastructure components:\n\n### 🗄️ SURREAL MEMORY\n\u003e *Context-augmentation memory system (vector \u0026 graph relationships)*\n\n- **Backend**: [SurrealDB](https://surrealdb.com/) multi-model database\n- **Vector Search**: Embedded similarity matching  \n- **Graph Relations**: Knowledge graph with entity linking\n- **Retention**: Global + project-local scoping\n- **Integration**: Full [Obsidian](https://obsidian.md/) knowledge-base support\n- **Visibility**: Transparent agent context inspection\n\n```rust\n// Example: Memory API\nsweetmcp::memory::store_context(\"project_id\", \u0026embedding, \u0026metadata).await?;\nlet related = sweetmcp::memory::semantic_search(\"query\", 0.8, 10).await?;\n```\n\n### 🔐 CRYYPT\n\u003e *[Post-quantum](https://en.wikipedia.org/wiki/Post-quantum_cryptography) encryption vault and secret management*\n\n- **Cryptography**: Military-grade, quantum-resistant algorithms\n- **Zero-Knowledge**: Agents never access raw credentials\n- **Architecture**: Pure Rust implementation with timing-safe operations\n- **Access Control**: Time-based expiration and role-based permissions\n- **Storage**: Encrypted vault with secure key derivation\n\n```rust\n// Example: Secret access without exposure\nlet result = cryypt::execute_with_secret(\"aws_key\", |secret| {\n    aws_client.authenticate(secret).call_api()\n}).await?;\n// Secret never leaves secure context\n```\n\n### 🎤 FLUENT VOICE\n\u003e *Pure-Rust AI voice system with predictive capabilities*\n\n- **STT**: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) speech-to-text\n- **Wake Words**: Native wake word detection\n- **Prediction**: Anticipatory text completion during speech\n- **TTS**: Pure-Rust Candle port of [Dia Voice](https://diaai.org/)\n- **Performance**: Low-latency, on-device processing\n- **Quality**: Expressive voice synthesis with emotional range\n\n```rust\n// Example: Voice interaction\nlet transcription = fluent_voice::listen_with_prediction().await?;\nlet response = fluent_voice::synthesize(\u0026text, Voice::Expressive).await?;\n```\n\n### ⚡ LOCAL AI\n\u003e *Autonomous [\"ambient agents\"](https://arxiv.org/abs/2407.01502) for background optimization*\n\n- **Architecture**: Self-configuring agent swarm\n- **Autonomy**: Zero direct user interaction required\n- **Capabilities**: \n  - Prompt optimization and auto-tuning\n  - Task decomposition and parallelization  \n  - Documentation procurement and indexing\n  - Preference learning and memorization\n- **Integration**: Assists primary AI models transparently\n\n```rust\n// Example: Ambient agent coordination\nambient::spawn_optimizer_for(primary_model_id).await?;\nambient::background_task_decomposer::register(complex_task).await?;\n```\n\n### 🧠 CODE GENERATION\n\u003e *Advanced reasoning and autocoding capabilities*\n\n- **Reasoning**: Deep reasoning chains with iterative refinement\n- **Search**: [MCTS (Monte Carlo Tree Search)](https://en.wikipedia.org/wiki/Monte_Carlo_tree_search) for solution exploration\n- **Research**: Deep research agents with multi-source synthesis\n- **Context**: Entire codebase understanding and analysis\n- **Generation**: Specialized models for different programming domains\n\n```rust\n// Example: Code generation with reasoning\nlet solution = code_gen::reason_and_generate(CodeRequest {\n    context: codebase_context,\n    requirements: user_spec,\n    search_strategy: SearchStrategy::MCTS,\n    reasoning_depth: 5\n}).await?;\n```\n\n### ∅ ZERO FRICTION\n\u003e *Universal tool integration without configuration*\n\n**Supported Platforms**:\n- [Claude Desktop](https://claude.ai/desktop) | [Claude Code](https://claude.ai/code)\n- [Windsurf](https://codeium.com/windsurf) | [Cursor.AI](https://cursor.sh/)\n- [VSCode](https://code.visualstudio.com/) | [Zed](https://zed.dev/)\n- [Raycast](https://raycast.com/) | [Cline](https://github.com/cline/cline) | [Roo Code](https://github.com/RooVetGit/Roo-Cline)\n- **+ thousands more via MCP standard**\n\n**Operating Systems**: Linux, macOS, Windows (all architectures)\n**Setup Time**: Literally zero - auto-discovery and configuration\n\n```json\n// Auto-generated MCP configuration\n{\n  \"mcpServers\": {\n    \"sweetmcp\": {\n      \"command\": \"sweetmcp\",\n      \"args\": [\"--stdio\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n---\n\n## 🔧 Technical Specifications\n\n### Protocol Support\n- **MCP (Model Context Protocol)** - Native first-class support\n- **JSON-RPC 2.0** - Full specification compliance  \n- **GraphQL** - Query-based tool invocation\n- **Cap'n Proto** - High-performance binary protocol\n\n### Performance Characteristics\n- **Latency**: Sub-millisecond tool routing\n- **Throughput**: 10K+ requests/second per core\n- **Memory**: Minimal footprint with smart caching\n- **Scaling**: Horizontal with service mesh discovery\n\n### Security Model\n- **Authentication**: JWT with configurable signing algorithms\n- **Transport**: TLS 1.3 with optional mTLS\n- **Rate Limiting**: Configurable per-endpoint throttling\n- **Isolation**: Process-level separation for tool execution\n\n### Service Endpoints\n```\nhttps://sweetmcp.cyrup.dev:8443   # Primary development endpoint\nhttps://sweetmcp.cyrup.ai:8443    # AI-optimized routing\nhttps://sweetmcp.cyrup.cloud:8443 # Cloud services integration  \nhttps://sweetmcp.cyrup.pro:8443   # Professional tooling\n```\n\n---\n\n## 🚀 Advanced Configuration\n\n### Environment Variables\n```bash\n# Core Configuration\nexport SWEETMCP_JWT_SECRET=\"$(openssl rand -base64 32)\"\nexport SWEETMCP_TCP_BIND=\"0.0.0.0:8443\"\nexport SWEETMCP_METRICS_BIND=\"127.0.0.1:9090\"\n\n# Performance Tuning\nexport SWEETMCP_INFLIGHT_MAX=1000\nexport SWEETMCP_WORKER_THREADS=8\nexport SWEETMCP_CONNECTION_POOL_SIZE=100\n\n# Discovery \u0026 Clustering\nexport SWEETMCP_DNS_SERVICE=\"_sweetmcp._tcp.example.com\"\nexport SWEETMCP_DISCOVERY_TOKEN=\"cluster-shared-secret\"\nexport SWEETMCP_NODE_ID=\"$(hostname)\"\n```\n\n### Clustering with DNS SRV\n```dns\n_sweetmcp._tcp.example.com. 300 IN SRV 10 50 8443 node1.example.com.\n_sweetmcp._tcp.example.com. 300 IN SRV 10 30 8443 node2.example.com.\n_sweetmcp._tcp.example.com. 300 IN SRV 20 20 8443 node3.example.com.\n```\n\n### Service Management\n```bash\n# Linux (systemd)\nsudo systemctl start|stop|restart cyrupd\nsudo systemctl enable cyrupd  # Auto-start on boot\njournalctl -u cyrupd -f       # Live logs\n\n# macOS (launchd)  \nsudo launchctl load|unload /Library/LaunchDaemons/com.cyrup.cyrupd.plist\ntail -f /var/log/cyrupd.log\n\n# Windows (sc)\nsc start|stop cyrupd\nsc config cyrupd start=auto\n```\n\n---\n\n## 🧪 API Examples\n\n### MCP Tool Invocation\n```bash\ncurl -X POST https://sweetmcp.cyrup.dev:8443/ \\\n  -H \"Authorization: Bearer $JWT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/call\", \n    \"params\": {\n      \"name\": \"file_operations/read\",\n      \"arguments\": {\"path\": \"/etc/hosts\"}\n    }\n  }'\n```\n\n### GraphQL Query\n```bash\ncurl -X POST https://sweetmcp.cyrup.dev:8443/graphql \\\n  -H \"Authorization: Bearer $JWT_TOKEN\" \\\n  -H \"Content-Type: application/graphql\" \\\n  -d 'query {\n    tools {\n      list {\n        name\n        description\n        inputSchema\n      }\n    }\n  }'\n```\n\n### Memory Operations\n```bash\n# Store context\ncurl -X POST https://sweetmcp.cyrup.dev:8443/ \\\n  -H \"Authorization: Bearer $JWT_TOKEN\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"memory/store\",\n    \"params\": {\n      \"content\": \"User prefers TypeScript over JavaScript\",\n      \"metadata\": {\"type\": \"preference\", \"user_id\": \"123\"}\n    }\n  }'\n\n# Semantic search\ncurl -X POST https://sweetmcp.cyrup.dev:8443/ \\\n  -H \"Authorization: Bearer $JWT_TOKEN\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\", \n    \"method\": \"memory/search\",\n    \"params\": {\n      \"query\": \"programming language preferences\",\n      \"threshold\": 0.8,\n      \"limit\": 5\n    }\n  }'\n```\n\n---\n\n## 🔬 Development \u0026 Debugging\n\n### Build from Source\n```bash\ngit clone git@github.com:cyrup-ai/sweetmcp.git\ncd sweetmcp\ncargo build --release\ncargo test --all-features\n```\n\n### Debug Mode\n```bash\nRUST_LOG=debug,sweetmcp=trace cargo run -- daemon --debug\n```\n\n### Health Checks\n```bash\n# Service health\ncurl -f https://sweetmcp.cyrup.dev:8443/health\n\n# Metrics (Prometheus format)\ncurl http://127.0.0.1:9090/metrics\n\n# Tool registry status\ncurl https://sweetmcp.cyrup.dev:8443/tools/list\n```\n\n---\n\n## 🗑️ Uninstallation\n\n```bash\n# Stop services\nsudo systemctl stop cyrupd \u0026\u0026 sudo systemctl disable cyrupd  # Linux\nsudo launchctl unload /Library/LaunchDaemons/com.cyrup.cyrupd.plist  # macOS\n\n# Remove daemon and certificates\nsudo cyrupd uninstall\n\n# Clean configuration (optional)\nrm -rf ~/.config/{cyrupd,sweetmcp}\nsudo sed -i '/# SweetMCP Auto-Integration/,+5d' /etc/hosts\n```\n\n---\n\n## 📚 Resources\n\n- **[API Documentation](https://docs.cyrup.ai/sweetmcp)** - Complete technical reference\n- **[MCP Specification](https://spec.modelcontextprotocol.io/)** - Protocol standards\n- **[GitHub Issues](https://github.com/cyrup-ai/sweetmcp/issues)** - Bug reports \u0026 features\n- **[Discord Community](https://discord.gg/cyrup-ai)** - Developer chat\n\n---\n\n## 📄 License\n\nDual licensed under **MIT** OR **Apache-2.0** - choose what works for your use case.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMade with 🍯 by \u003ca href=\"https://github.com/cyrup-ai\"\u003eCyrup.ai\u003c/a\u003e\u003c/strong\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyrup-ai%2Fsweetmcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyrup-ai%2Fsweetmcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyrup-ai%2Fsweetmcp/lists"}