Sanctum Core Module: MCP Server

🚨 IMPORTANT NOTICE FOR NEW DEVELOPERS 🚨

This repository has been graduated to Sanctum Core Module status!

For new development, please use the canonical source: → github.com/sanctumos/smcp ←

This repository remains available for users who prefer to continue using this version, but new features and updates will be developed in the official Sanctum repository.

A powerful, plugin-based Model Context Protocol (MCP) server for the Sanctum AI framework. This server provides seamless integration between AI clients and external tools through a robust plugin architecture. As a Sanctum Core Module, it represents the official, production-ready implementation maintained by the Sanctum team.

🚀 Features

• Plugin Architecture: Easy-to-write plugins for any external service or tool
• MCP Protocol Compliant: Full support for the Model Context Protocol specification
• SSE Transport: Real-time server-sent events for efficient communication
• JSON-RPC 2.0: Standardized request/response handling
• Auto-Discovery: Automatic plugin detection and tool registration
• Health Monitoring: Built-in health checks and status reporting
• Production Ready: Comprehensive error handling and logging

📦 Installation

Prerequisites

• Python 3.8 or higher
• pip package manager

Quick Start

1. Clone the repository

   git clone https://github.com/sanctumos/smcp.git
   cd sanctum-letta-mcp
   

2. Create virtual environment

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

3. Install dependencies

   pip install -r requirements.txt
   

4. Run the server

   python smcp/mcp_server.py
   

The server will start on http://localhost:8000 by default with localhost + Docker container access for development environments.

Security Features

By default, the server binds to all interfaces (0.0.0.0) to allow connections from both the local machine and Docker containers running on the same host. This is ideal for development environments where Docker containers need to communicate with the MCP server.

For localhost-only access (more restrictive):

python smcp/mcp_server.py --host 127.0.0.1

To allow external connections (use with caution):

python smcp/mcp_server.py --allow-external

Custom port:

python smcp/mcp_server.py --port 9000

Custom host binding: