# clotohub-servers

> [!IMPORTANT]
> **This repository will become private on June 25, 2026.**
>
> First-party connector distribution has moved to [ClotoHub.dev](https://hub.cloto.dev). ClotoCore installs these servers through the marketplace catalog, which serves hub-mirrored artifacts and no longer depends on this repository being public.
>
> - Browse and install connectors: https://hub.cloto.dev (or the in-app marketplace in ClotoCore)
> - The MGP protocol remains fully open: [mgp-spec](https://github.com/Cloto-dev/mgp-spec) (MIT), [mgp-rs](https://github.com/Cloto-dev/mgp-rs) (MIT), [CPersona](https://github.com/Cloto-dev/cpersona) (MIT)
>
> If you currently clone this repository directly, please migrate to the catalog within the notice period.

[![License](https://img.shields.io/badge/license-BSL%201.1%20%E2%86%92%20MIT%202028-blue)](LICENSE)
[![Tests](https://img.shields.io/badge/tests-429%20passing-brightgreen)]()

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