clotohub-servers

# clotohub-servers [](LICENSE) []() MCP server collection for the [ClotoCore](https://github.com/Cloto-dev/ClotoCore) platform. ## CPersona — moved to its own repository **CPersona** (the AI memory server formerly at `servers/cpersona/`) now lives in the [CPersona standalone repository](https://github.com/Cloto-dev/CPersona) (MIT). It remains installable from the [ClotoHub marketplace](https://hub.cloto.dev) and usable from Claude Desktop, Claude Code, or any other MCP client — see the standalone README for setup instructions. ## All Servers | ID | Type | Description | |----|------|-------------| | `tool.embedding` | Tool | Vector embedding generation (ONNX + API providers) | | `tool.terminal` | Tool | Sandboxed command execution | | `tool.agent_utils` | Tool | Deterministic utilities (time, math, UUID, units, encode/decode) | | `tool.cron` | Tool | CRON job management | | `tool.websearch` | Tool | Web search integration (SearXNG, Tavily, DuckDuckGo) | | `tool.imagegen` | Tool | Stable Diffusion image generation | | `mind.cerebras` | Mind | Cerebras ultra-high-speed reasoning | | `mind.deepseek` | Mind | DeepSeek reasoning engine | | `mind.claude` | Mind | Claude/Anthropic reasoning engine | | `mind.ollama` | Mind | Ollama local LLM | | `vision.gaze_webcam` | Vision | Webcam gaze tracking | | `vision.capture` | Vision | Image capture with Ollama + OCR | | `voice.stt` | Voice | Speech-to-text (Whisper) | | `output.avatar` | Output | VRM expression, idle behavior, and VOICEVOX TTS (Rust) | | `io.discord` | I/O | Bidirectional Discord communication via MGP events (Rust) | | `tool.example` | Example | Reference MGP server implementation for new authors | ## MGP Protocol Documentation ClotoCore extends MCP with [MGP (Multi-Agent Gateway Protocol)](docs/MGP_SPEC.md) — a strict superset adding security, lifecycle, and bidirectional communication. - [MGP Specification](docs/MGP_SPEC.md) — Protocol overview and architecture - [MGP Security](docs/MGP_SECURITY.md) — Permission model, RBAC, audit trail - [MGP Communication](docs/MGP_COMMUNICATION.md) — Lifecycle, streaming, events - [MGP Discovery](docs/MGP_DISCOVERY.md) — Dynamic tool discovery - [MGP Guide](docs/MGP_GUIDE.md) — Implementation guide for server authors - [MGP Isolation](docs/MGP_ISOLATION_DESIGN.md) — OS-level enforcement design ## Build Your Own Server See `servers/example/server.py` for a complete reference implementation, or follow the [Quickstart Guide](https://github.com/Cloto-dev/ClotoCore/blob/master/docs/QUICKSTART_MCP_SERVER.md) to create a working MCP/MGP server in 5 minutes. ## Setup (all servers) ```bash 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 bash scripts/setup-deps.sh ``` ## Integration with ClotoCore This repo is consumed by ClotoCore via `mcp.toml`'s `[paths]` section: ```toml [paths] servers = "/path/to/clotohub-servers/servers" ``` Server args use `${servers}` variable expansion: ```toml [[servers]] id = "tool.terminal" command = "python" args = ["${servers}/terminal/server.py"] ``` ## Testing ```bash cd servers python -m pytest tests/ -v ``` ## License This repository uses a dual-license model: | Component | License | |---|---| | **MGP Protocol** (`docs/MGP_*.md`) | MIT | | All other servers and code | BSL 1.1 (converts to MIT on 2028-02-14) | See [LICENSE](LICENSE) for the BSL 1.1 terms. MGP documentation is independently MIT-licensed to enable adoption by any MCP host without restriction. [CPersona](https://github.com/Cloto-dev/CPersona) (formerly part of this repo) is MIT-licensed in its own repository. Contact: ClotoCore@proton.me