cloto-mcp-servers

MCP server collection for the ClotoCore platform.

CPersona — AI Memory Server

CPersona (servers/cpersona/) is an MCP Memory Server that gives Claude persistent memory. See the cpersona README for full documentation.

• 3-layer hybrid search (vector + FTS5 full-text + keyword) with RRF merge

• Confidence scoring with dynamic time decay, recall boost, and completion factor

• Episodic memory (conversation summarization) and profile memory (user attributes)

• Zero LLM dependency — pure data server, all intelligence stays in the calling agent

• 16 tools including health check, auto-calibration, JSONL export/import, and agent merge

• Agent namespace isolation

• stdio + Streamable HTTP transport

• Single-file SQLite DB (schema v7, auto-migrating)

License: MIT — free to use from any MCP host.

Quick Start (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 — add to 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: use .venv/Scripts/python.exe instead of .venv/bin/python, and C:/Users/yourname/.claude/cpersona.db for the DB path.

Note: Claude Desktop on Windows has known issues with stdio MCP transport (payload size limits, silent drops). If you experience problems, consider using cpersona's Streamable HTTP transport instead. See the Zenn Book Ch.2 for 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

Adjust paths to match your environment. For detailed setup instructions, see the Zenn Book Ch.2.

All Servers

MGP Protocol Documentation

ClotoCore extends MCP with MGP (Multi-Agent Gateway Protocol) — a strict superset adding security, lifecycle, and bidirectional communication.

• MGP Specification — Protocol overview and architecture

• MGP Security — Permission model, RBAC, audit trail

• MGP Communication — Lifecycle, streaming, events

• MGP Discovery — Dynamic tool discovery

• MGP Guide — Implementation guide for server authors

• MGP Isolation — OS-level enforcement design

Build Your Own Server

See servers/example/server.py for a complete reference implementation, or follow the Quickstart Guide to create a working MCP/MGP server in 5 minutes.

Setup (all servers)

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

Or use the setup script:

bash scripts/setup-deps.sh

Integration with ClotoCore

This repo is consumed by ClotoCore via mcp.toml's [paths] section:

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

Server args use ${servers} variable expansion:

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

Testing

cd servers
python -m pytest tests/ -v

License

This repository uses a dual-license model:

See LICENSE for the BSL 1.1 terms. CPersona and MGP are independently MIT-licensed to enable adoption by any MCP host without restriction.

Contact: ClotoCore@proton.me