cloto-mcp-servers

Colección de servidores MCP para la plataforma ClotoCore.

CPersona — Servidor de memoria para IA

CPersona (servers/cpersona/) es un servidor de memoria MCP que proporciona memoria persistente a Claude. Consulta el README de cpersona para ver la documentación completa.

Usuarios autónomos: Para su uso con Claude Desktop, Claude Code u otros clientes MCP sin ClotoCore, consulta el repositorio autónomo de cpersona.

• Búsqueda híbrida de 3 capas (vectorial + texto completo FTS5 + palabras clave) con fusión RRF

• Puntuación de confianza con decaimiento temporal dinámico, impulso de recuperación y factor de finalización

• Memoria episódica (resumen de conversaciones) y memoria de perfil (atributos del usuario)

• Cero dependencia de LLM: servidor de datos puro, toda la inteligencia permanece en el agente que realiza la llamada

• 16 herramientas que incluyen comprobación de estado, autocalibración, exportación/importación JSONL y fusión de agentes

• Aislamiento de espacio de nombres de agente

• Transporte stdio + HTTP transmitible (Streamable)

• Base de datos SQLite de archivo único (esquema v7, migración automática)

Licencia: MIT — de uso libre desde cualquier host MCP.

Inicio rápido (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 — añadir a 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: utiliza .venv/Scripts/python.exe en lugar de .venv/bin/python, y C:/Users/tunombre/.claude/cpersona.db para la ruta de la base de datos.

Nota: Claude Desktop en Windows tiene problemas conocidos con el transporte MCP stdio (límites de tamaño de carga útil, caídas silenciosas). Si experimentas problemas, considera usar el transporte HTTP transmitible de cpersona en su lugar. Consulta el Capítulo 2 del libro Zenn para más detalles.

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

Ajusta las rutas para que coincidan con tu entorno. Para obtener instrucciones de configuración detalladas, consulta el Capítulo 2 del libro Zenn.

Related MCP server: qualixar/superlocalmemory

Todos los servidores

Documentación del protocolo MGP

ClotoCore extiende MCP con MGP (Multi-Agent Gateway Protocol) — un superconjunto estricto que añade seguridad, ciclo de vida y comunicación bidireccional.

• Especificación MGP — Visión general y arquitectura del protocolo

• Seguridad MGP — Modelo de permisos, RBAC, registro de auditoría

• Comunicación MGP — Ciclo de vida, streaming, eventos

• Descubrimiento MGP — Descubrimiento dinámico de herramientas

• Guía MGP — Guía de implementación para autores de servidores

• Aislamiento MGP — Diseño de cumplimiento a nivel de SO

Crea tu propio servidor

Consulta servers/example/server.py para obtener una implementación de referencia completa, o sigue la Guía de inicio rápido para crear un servidor MCP/MGP funcional en 5 minutos.

Configuración (todos los servidores)

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

O utiliza el script de configuración:

bash scripts/setup-deps.sh

Integración con ClotoCore

Este repositorio es consumido por ClotoCore a través de la sección [paths] de mcp.toml:

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

Los argumentos del servidor utilizan la expansión de variables ${servers}:

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

Pruebas

cd servers
python -m pytest tests/ -v

Licencia

Este repositorio utiliza un modelo de licencia dual:

Consulta LICENSE para conocer los términos de la BSL 1.1. CPersona y MGP tienen licencia MIT independiente para permitir su adopción por cualquier host MCP sin restricciones.

Contacto: ClotoCore@proton.me