SMCP

Why Do You Need SMCP?

Your AI assistant is powerful, but it can only do what it's trained to do. SMCP bridges the gap between your AI and the real world, giving it access to tools, services, and capabilities it never had before—without retraining or complex integrations.

What Can Your AI Do with SMCP?

The possibilities are endless. Here are just a few ways SMCP can enhance your AI's capabilities:

Why SMCP is Different

• Plug & Play Skills — Add new capabilities instantly. Just drop in a plugin and your AI gains new abilities automatically.
• Works with Popular AI Tools — Built on the Model Context Protocol standard, compatible with all MCP-enabled AI frameworks.
• Real-time Communication — Your AI responds instantly with live updates and bidirectional communication.
• Simple & Reliable — Battle-tested architecture that just works. No complex setup or configuration needed.
• Easy Plugin Creation — Write plugins in simple Python. No deep technical knowledge required—just code what you need.
• Always Available — Built-in health monitoring ensures your AI's new skills are always ready when you need them.
• Production Ready — Trusted by developers and AI enthusiasts. Comprehensive error handling and logging keep everything running smoothly.

Built on Open Standards

SMCP implements the Model Context Protocol (MCP) specification, ensuring compatibility with the entire MCP ecosystem. For developers: we use JSON-RPC 2.0 for message handling and Server-Sent Events (SSE) for real-time communication.

Endpoints

Message Format

All messages follow the JSON-RPC 2.0 specification:

{
  "jsonrpc": "2.0",
  "id": "unique-request-id",
  "method": "method-name",
  "params": {
    // Method-specific parameters
  }
}

Core MCP Methods

How It Works

SMCP uses a simple plugin system that automatically discovers and activates new skills. Just add a plugin, and your AI gains new abilities instantly.

Plugin Discovery

The server automatically discovers plugins by scanning the plugin directory for subdirectories containing a cli.py file. Each plugin directory represents a plugin namespace.

plugins/
├── botfather/
│   ├── __init__.py
│   └── cli.py
├── devops/
│   ├── __init__.py
│   └── cli.py
└── your_plugin/
    ├── __init__.py
    └── cli.py

Transport

• Server-Sent Events (SSE) — Bidirectional SSE for real-time communication with Letta clients
• HTTP POST — JSON-RPC 2.0 message handling via REST endpoint
• Localhost by Default — Secure default binding to 127.0.0.1

Create Your Own Skills

SMCP's plugin system makes it easy to give your AI new abilities. Each plugin is automatically discovered and its commands become new skills your AI can use.

Vibe Code Your Own Plugin

Plugins are simple Python scripts. Here's how easy it is to create one:

#!/usr/bin/env python3
"""
My Plugin CLI
"""
import argparse
import json
import sys

def main():
    parser = argparse.ArgumentParser(description="My Plugin CLI")
    subparsers = parser.add_subparsers(dest="command")
    
    cmd_parser = subparsers.add_parser("my-command", help="Execute my command")
    cmd_parser.add_argument("--param", required=True, help="Required parameter")
    
    args = parser.parse_args()
    
    if args.command == "my-command":
        result = execute_my_command(args.param)
        print(json.dumps(result))
    else:
        parser.print_help()
        sys.exit(1)

if __name__ == "__main__":
    main()

Available Plugins

For comprehensive plugin development documentation, see the Plugin Development Guide.

Get Started in Minutes

Getting started with SMCP is simple. Install it, add a plugin, and your AI gains new skills instantly.

What You Need

• Python 3.8 or higher
• pip package manager

Quick Start

# Clone the repository
git clone https://github.com/sanctumos/smcp.git
cd smcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the server
python smcp.py

The server will start on http://localhost:8000 by default with localhost-only access for security.

Configuration Options

Documentation & Resources