cloto-mcp-servers

MCP-Serversammlung für die ClotoCore-Plattform.

CPersona — KI-Speicherserver

CPersona (servers/cpersona/) ist ein MCP-Speicherserver, der Claude einen persistenten Speicher verleiht. Siehe die cpersona README für die vollständige Dokumentation.

Eigenständige Benutzer: Für die Verwendung mit Claude Desktop, Claude Code oder anderen MCP-Clients ohne ClotoCore, siehe das cpersona-Standalone-Repository.

• Hybride 3-Schichten-Suche (Vektor + FTS5-Volltext + Schlüsselwort) mit RRF-Zusammenführung

• Konfidenzbewertung mit dynamischem Zeitverfall, Recall-Boost und Vervollständigungsfaktor

• Episodisches Gedächtnis (Konversationszusammenfassung) und Profilgedächtnis (Benutzerattribute)

• Keine LLM-Abhängigkeit — reiner Datenserver, die gesamte Intelligenz verbleibt im aufrufenden Agenten

• 16 Tools, einschließlich Gesundheitsprüfung, automatischer Kalibrierung, JSONL-Export/Import und Agenten-Zusammenführung

• Agenten-Namensraum-Isolierung

• stdio + Streamable HTTP-Transport

• Einzeldatei-SQLite-DB (Schema v7, automatische Migration)

Lizenz: MIT — frei verwendbar von jedem MCP-Host.

Schnellstart (Claude Desktop / Claude Code)

git clone https://github.com/Cloto-dev/cloto-mcp-servers.git
cd cloto-mcp-servers/servers
python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS / Linux
# source .venv/bin/activate

pip install -r requirements.lock

Claude Desktop — hinzufügen zu claude_desktop_config.json:

{
  "mcpServers": {
    "embedding": {
      "command": "/path/to/servers/.venv/bin/python",
      "args": ["/path/to/servers/embedding/server.py"],
      "env": {
        "EMBEDDING_PROVIDER": "onnx_jina_v5_nano",
        "EMBEDDING_HTTP_PORT": "8401"
      }
    },
    "cpersona": {
      "command": "/path/to/servers/.venv/bin/python",
      "args": ["/path/to/servers/cpersona/server.py"],
      "env": {
        "CPERSONA_DB_PATH": "/home/yourname/.claude/cpersona.db",
        "CPERSONA_EMBEDDING_MODE": "http",
        "CPERSONA_EMBEDDING_URL": "http://127.0.0.1:8401/embed",
        "CPERSONA_VECTOR_SEARCH_MODE": "remote"
      }
    }
  }
}

Windows: Verwenden Sie .venv/Scripts/python.exe anstelle von .venv/bin/python und C:/Users/IhrName/.claude/cpersona.db für den DB-Pfad.

Hinweis: Claude Desktop unter Windows hat bekannte Probleme mit dem stdio-MCP-Transport (Payload-Größenbeschränkungen, stille Abbrüche). Wenn Sie Probleme haben, ziehen Sie stattdessen den Streamable-HTTP-Transport von cpersona in Betracht. Siehe das Zenn Book Kap. 2 für Details.

Claude Code:

# macOS / Linux
claude mcp add-json embedding '{
  "type": "stdio",
  "command": "/path/to/servers/.venv/bin/python",
  "args": ["/path/to/servers/embedding/server.py"],
  "env": {
    "EMBEDDING_PROVIDER": "onnx_jina_v5_nano",
    "EMBEDDING_HTTP_PORT": "8401"
  }
}' -s user

claude mcp add-json cpersona '{
  "type": "stdio",
  "command": "/path/to/servers/.venv/bin/python",
  "args": ["/path/to/servers/cpersona/server.py"],
  "env": {
    "CPERSONA_DB_PATH": "/home/yourname/.claude/cpersona.db",
    "CPERSONA_EMBEDDING_MODE": "http",
    "CPERSONA_EMBEDDING_URL": "http://127.0.0.1:8401/embed",
    "CPERSONA_VECTOR_SEARCH_MODE": "remote"
  }
}' -s user

Passen Sie die Pfade an Ihre Umgebung an. Detaillierte Einrichtungsanweisungen finden Sie im Zenn Book Kap. 2.

Related MCP server: qualixar/superlocalmemory

Alle Server

MGP-Protokolldokumentation

ClotoCore erweitert MCP um MGP (Multi-Agent Gateway Protocol) — eine strikte Obermenge, die Sicherheit, Lebenszyklus und bidirektionale Kommunikation hinzufügt.

• MGP-Spezifikation — Protokollübersicht und Architektur

• MGP-Sicherheit — Berechtigungsmodell, RBAC, Audit-Trail

• MGP-Kommunikation — Lebenszyklus, Streaming, Ereignisse

• MGP-Discovery — Dynamische Tool-Erkennung

• MGP-Leitfaden — Implementierungsleitfaden für Serverautoren

• MGP-Isolierung — Design der Durchsetzung auf Betriebssystemebene

Erstellen Sie Ihren eigenen Server

Siehe servers/example/server.py für eine vollständige Referenzimplementierung oder folgen Sie dem Schnellstart-Leitfaden, um in 5 Minuten einen funktionierenden MCP/MGP-Server zu erstellen.

Einrichtung (alle Server)

cd servers
python -m venv .venv

# Activate (Windows Git Bash)
source .venv/Scripts/activate
# Activate (Linux/macOS)
# source .venv/bin/activate

pip install --upgrade pip
for d in */; do [ -f "$d/pyproject.toml" ] && pip install "$d"; done

Oder verwenden Sie das Setup-Skript:

bash scripts/setup-deps.sh

Integration mit ClotoCore

Dieses Repo wird von ClotoCore über den Abschnitt [paths] in mcp.toml konsumiert:

[paths]
servers = "/path/to/cloto-mcp-servers/servers"

Server-Argumente verwenden ${servers}-Variablenerweiterung:

[[servers]]
id = "tool.terminal"
command = "python"
args = ["${servers}/terminal/server.py"]

Testen

cd servers
python -m pytest tests/ -v

Lizenz

Dieses Repository verwendet ein Dual-Lizenz-Modell:

Siehe LICENSE für die BSL 1.1-Bedingungen. CPersona und MGP sind unabhängig MIT-lizenziert, um die Übernahme durch jeden MCP-Host ohne Einschränkungen zu ermöglichen.

Kontakt: ClotoCore@proton.me