Magec MCP server
2026년 11월 8일 커밋시각적 워크플로우 오케스트레이션, 음성 제어 및 MCP 도구 통합을 지원하는 셀프 호스팅 멀티 에이전트 AI 플랫폼입니다.
다른 이름 achetronic/magec
- 스타
- 112
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 8일
- 라이선스
- Apache-2.0
Magec MCP란?
Magec은(는) MCP server입니다. 시각적 워크플로우 오케스트레이션, 음성 제어 및 MCP 도구 통합을 지원하는 셀프 호스팅 멀티 에이전트 AI 플랫폼입니다.
프로젝트 README에서 생성된 요약
Magec MCP server 정보
Magec은 개발자와 개인정보 보호를 중시하는 사용자가 시각적 그래프와 음성 명령을 통해 멀티 에이전트 AI 워크플로우를 오케스트레이션할 수 있도록 지원합니다. 이 셀프 호스팅 플랫폼을 사용하면 각기 다른 LLM, 메모리, 특정 도구를 갖춘 여러 에이전트를 정의할 수 있습니다. 라우터, 조인, 루프, 병렬 팬아웃을 지원하는 시각적 그래프 에디터를 사용하여 이러한 에이전트들을 복잡한 시퀀스로 연결할 수 있습니다.
사용자는 Docker Compose를 사용하여 시스템을 로컬에 배포할 수 있으며, 이를 통해 로컬 LLM을 위한 Ollama부터 메모리 관리를 위한 PostgreSQL 및 Redis까지 모든 환경을 구축할 수 있습니다. OpenAI, Anthropic, Gemini 및 모든 OpenAI 호환 API를 포함한 다양한 백엔드를 지원합니다. 또한 HTTP 또는 stdio 전송 방식을 통해 GitHub, Home Assistant, 데이터베이스와 같은 MCP 도구와 통합됩니다.
상호작용은 Voice UI, Telegram, Discord, Slack 또는 웹훅을 포함한 다양한 인터페이스를 통해 이루어집니다. 로컬 제어가 필요한 사용자의 경우, 파일 시스템, git 및 셸 도구를 관리하기에 적합한 바이너리 설치 방식이 이상적입니다. 시스템은 암호화된 비밀 관리 기능과 모든 실행을 추적할 수 있는 실행 감사 타임라인 기능도 제공합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능achetronic/magec is public and reachablegithub.com/achetronic/magec ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-08github.com/achetronic/magec ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Magec
Define multiple AI agents, each with its own LLM, memory, and tools. Chain them into multi-step workflows. Access via voice, Telegram, webhooks, or cron. Manage it all from a visual admin panel.
Your server, your data, your rules.
Quick Start
One-line install (fully local, no API keys)
curl -fsSL https://raw.githubusercontent.com/achetronic/magec/master/scripts/install.sh | bash
Downloads a Docker Compose file with everything: LLM (Ollama), STT (Parakeet), TTS (Edge TTS), embeddings, Redis, PostgreSQL. Add --gpu for NVIDIA acceleration.
Docker with OpenAI (minimal)
docker run -d --name magec \
-p 8080:8080 -p 8081:8081 \
-v $(pwd)/config.yaml:/app/config.yaml \
-v magec_data:/app/data \
ghcr.io/achetronic/magec:latest
Create backends, agents, and clients from the Admin UI. See the Docker Quick Start guide.
Binary
Download from Releases, extract, and run:
./magec --config config.yaml
Ideal for local MCP tools (filesystem, git, shell). See the Binary Installation guide.
Admin UI → http://localhost:8081 · Voice UI → http://localhost:8080
Highlights
- Multi-agent: per-agent LLM, memory, voice, and tools. Hot-reload from the Admin UI.
- Agentic Flows: visual graph editor. Agents, routers, joins, loops, parallel fan-out, and code blocks (CEL and Starlark).
- Run auditing: every execution recorded and browsable as a timeline; conversations projected from the same data.
- Secrets: encrypted at rest, usable by agents and flows through placeholders the models never see resolved.
- Any backend: OpenAI, Anthropic, Gemini, Ollama, or any OpenAI-compatible API.
- MCP tools: Home Assistant, GitHub, databases, and hundreds more via Model Context Protocol.
- Memory: session (Redis) + long-term semantic (PostgreSQL/pgvector).
- Voice: wake word, VAD, STT, TTS. All server-side via ONNX Runtime. Privacy-first.
- Clients: Voice UI (PWA), Telegram, Discord, Slack, webhooks, cron, REST API.
- A2A: expose agents and flows to other agent platforms via the Agent-to-Agent protocol.
Screenshots
See all screenshots in the documentation.
Roadmap
- Multi-agent system with per-agent LLM, memory, and tools
- Visual flow editor
- MCP tool integration (HTTP + stdio transports)
- Voice UI with wake word detection and VAD
- Telegram client with voice support
- Long-term semantic memory (pgvector)
- Session memory (Redis)
- Webhook and cron clients
- Admin UI with hot-reload
- Secrets management (encrypted storage for API keys and sensitive credentials)
- Slack client
- Context window management: automatic summarization when approaching token limits (experimental)
- Expose agents and flows with A2a (Agent-to-agent) protocol
- Discord client
- Flows as real graphs (routers, joins, loops, fan-out, CEL/Starlark blocks)
- Run auditing with per-block timelines
- Secrets usable by agents and flows without exposing values to the models
Documentation
Full docs at magec.dev/docs: installation, configuration, agents, flows, backends, memory, MCP tools, clients, voice system, and API reference.
Development
Requirements
- Go 1.25+
- Node.js 22+ (for UI builds)
- Docker (for infrastructure services)
Make commands
| Command | Description |
|---|---|
make build |
Build frontend UIs + embed models + compile server binary |
make dev |
Build all and start server |
make dev-admin |
Start Admin UI dev server (Vite, hot-reload) |
make dev-voice |
Start Voice UI dev server (Vite, hot-reload) |
make swagger |
Regenerate Swagger docs |
make infra |
Start PostgreSQL + Redis |
make ollama |
Start Ollama with qwen3:8b + nomic-embed-text |
make docker-build |
Build Docker image (current arch) |
make docker-buildx |
Build multi-arch image (amd64 + arm64) |
make clean |
Remove build artifacts |
Key dependencies
| Dependency | Purpose |
|---|---|
| google.golang.org/adk | Google Agent Development Kit |
| modelcontextprotocol/go-sdk | MCP client |
| yalue/onnxruntime_go | ONNX Runtime for wake word / VAD |
| mymmrac/telego | Telegram bot |
| achetronic/adk-utils-go | ADK providers, session, memory |
| yuin/goldmark | CommonMark + GFM parser for Telegram HTML rendering |
Special Mentions
| Who | What |
|---|---|
| @travisvn | Built the ARM64 Docker image for OpenAI Edge TTS in record time. This is the local TTS service we recommend: it exposes an OpenAI-compatible API (/v1/audio/speech) that uses Microsoft Edge's free neural voices under the hood, so Magec can use it as a drop-in replacement for OpenAI TTS. |
Contributors
License
Apache 2.0 · Alby Hernández