cloto-mcp-servers

Коллекция MCP-серверов для платформы ClotoCore.

CPersona — сервер памяти ИИ

CPersona (servers/cpersona/) — это MCP-сервер памяти, который предоставляет Claude постоянную память. Полную документацию см. в README для cpersona.

Автономные пользователи: Для использования с Claude Desktop, Claude Code или другими MCP-клиентами без ClotoCore см. автономный репозиторий cpersona.

• 3-уровневый гибридный поиск (векторный + полнотекстовый FTS5 + по ключевым словам) с объединением RRF

• Оценка достоверности с динамическим затуханием во времени, повышением релевантности и коэффициентом завершенности

• Эпизодическая память (обобщение диалогов) и профильная память (атрибуты пользователя)

• Нулевая зависимость от LLM — чистый сервер данных, весь интеллект остается в вызывающем агенте

• 16 инструментов, включая проверку работоспособности, автокалибровку, экспорт/импорт JSONL и объединение агентов

• Изоляция пространств имен агентов

• Транспорт stdio + Streamable HTTP

• Однофайловая база данных SQLite (схема v7, автоматическая миграция)

Лицензия: MIT — бесплатна для использования с любым MCP-хостом.

Быстрый старт (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 — добавьте в 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: используйте .venv/Scripts/python.exe вместо .venv/bin/python и C:/Users/yourname/.claude/cpersona.db в качестве пути к БД.

Примечание: Claude Desktop в Windows имеет известные проблемы с транспортом stdio MCP (ограничения размера полезной нагрузки, скрытые сбои). Если вы столкнулись с проблемами, рассмотрите возможность использования транспорта Streamable HTTP от cpersona. Подробности см. в Zenn Book, гл. 2.

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

Настройте пути в соответствии с вашей средой. Подробные инструкции по настройке см. в Zenn Book, гл. 2.

Related MCP server: qualixar/superlocalmemory

Все серверы

Документация протокола MGP

ClotoCore расширяет MCP с помощью MGP (Multi-Agent Gateway Protocol) — строгого надмножества, добавляющего безопасность, жизненный цикл и двунаправленную связь.

• Спецификация MGP — Обзор протокола и архитектура

• Безопасность MGP — Модель разрешений, RBAC, журнал аудита

• Связь MGP — Жизненный цикл, потоковая передача, события

• Обнаружение MGP — Динамическое обнаружение инструментов

• Руководство MGP — Руководство по реализации для авторов серверов

• Изоляция MGP — Проектирование принудительной изоляции на уровне ОС

Создайте свой собственный сервер

См. servers/example/server.py для получения полной эталонной реализации или следуйте Руководству по быстрому старту, чтобы создать рабочий MCP/MGP-сервер за 5 минут.

Настройка (все серверы)

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

Или используйте скрипт настройки:

bash scripts/setup-deps.sh

Интеграция с ClotoCore

Этот репозиторий используется ClotoCore через раздел [paths] в mcp.toml:

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

Аргументы сервера используют расширение переменных ${servers}:

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

Тестирование

cd servers
python -m pytest tests/ -v

Лицензия

Этот репозиторий использует модель двойного лицензирования:

См. LICENSE для условий BSL 1.1. CPersona и MGP независимо лицензированы по MIT, чтобы обеспечить возможность их использования любым MCP-хостом без ограничений.

Контакт: ClotoCore@proton.me