Matterbridge

Репозиторий: MCP-сервер на Go (stdio), который вызывает HTTP API Matterbridge. Сам Matterbridge в дереве исходников нет — в Docker поднимается готовый образ ghcr.io/matterbridge-org/matterbridge (см. docker-compose.yml; upstream-история: 42wim/matterbridge).

Путь к клону (пример): ~/matterbridge-mcp — в WSL обычно /home/<username>/matterbridge-mcp; с Windows через WSL: \\wsl.localhost\Ubuntu\home\<username>\matterbridge-mcp.

Два процесса

1. Matterbridge (docker compose up -d) — держи запущенным, пока нужны мост и API на :4242.
2. matterbridge-mcp — подпроцесс MCP-клиента на время сессии; ходит в уже работающий Matterbridge по HTTP.

Доп. контекст в Obsidian: Matterbridge-plan.md (vault).

Быстрый старт

cd ~/matterbridge-mcp
go mod tidy
go test ./... -count=1
docker compose up -d matterbridge
./scripts/smoke-api.sh
go build -o bin/matterbridge-mcp ./cmd/matterbridge-mcp
go run ./cmd/mcp-probe ./bin/matterbridge-mcp

Полный прогон: chmod +x scripts/*.sh && ./scripts/e2e-local.sh

MCP: настройка и tools

Полная документация MCP (транспорт, env, аргументы tools, Cursor, Claude Desktop, отладка): docs/MCP.md.

Кратко: три tool — matterbridge_send → POST /api/message, matterbridge_messages → GET /api/messages, matterbridge_health → GET /api/health. Примеры конфигов: cursor-mcp.json.example, claude_desktop_config.json.example.

Документация

• docs/MCP.md — MCP (stdio, tools, клиенты, типичные ошибки)
• PLAN.md
• TESTING.md
• AGENT-TEST-PLAYBOOK.md
• Obsidian: Matterbridge-plan.md на D: при монтировании — /mnt/d/0.Home vault/Matterbridge-plan.md

Docker (образ MCP)

docker build -t matterbridge-mcp:local .