Magec MCP sunucusu
Commit 8 Kas 2026Görsel iş akışı orkestrasyonu, sesli kontrol ve MCP araçlarıyla entegrasyon sağlayan, kendi sunucunuzda barındırabileceğiniz çoklu ajanlı bir yapay zeka platformu.
Ayrıca bilinen adı achetronic/magec
- Yıldızlar
- 112
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 8 Kas 2026
- Lisans
- Apache-2.0
Magec MCP nedir?
Görsel iş akışı orkestrasyonu, sesli kontrol ve MCP araçlarıyla entegrasyon sağlayan, kendi sunucunuzda barındırabileceğiniz çoklu ajanlı bir yapay zeka platformu.
Özet, projenin README dosyasından oluşturuldu
Magec MCP sunucusu hakkında
Magec, geliştiricilerin ve gizlilik odaklı kullanıcıların görsel grafikler ve sesli komutlar aracılığıyla çoklu ajanlı yapay zeka iş akışlarını orkestre etmelerini sağlar. Bu self-hosted platform, her biri kendi LLM'ine, belleğine ve belirli araçlarına sahip birden fazla ajanı tanımlamanıza olanak tanır. Bu ajanları; yönlendiriciler (routers), birleştiriciler (joins), döngüler (loops) ve paralel dağıtımlar (parallel fan-out) destekleyen görsel bir grafik editörü kullanarak karmaşık dizilere bağlayabilirsiniz.
Kullanıcılar, yerel LLM'ler için Ollama'dan bellek için PostgreSQL ve Redis'e kadar her şeyi kuran Docker Compose kullanarak sistemi yerel olarak dağıtabilirler. OpenAI, Anthropic, Gemini ve OpenAI uyumlu herhangi bir API dahil olmak üzere çeşitli backend'leri destekler. Platform; GitHub, Home Assistant ve veritabanları gibi MCP araçlarıyla HTTP veya stdio taşıma protokolleri üzerinden entegre olur.
Etkileşim; Sesli Kullanıcı Arayüzü (Voice UI), Telegram, Discord, Slack veya webhook'lar dahil olmak üzere çeşitli arayüzler üzerinden gerçekleşir. Yerel kontrol ihtiyacı duyanlar için binary kurulumu; dosya sistemi, git ve shell araçlarını yönetmek adına idealdir. Sistem ayrıca şifrelenmiş secret yönetimi ve her yürütmeyi takip etmek için bir çalışma denetim zaman çizelgesi (run auditing timeline) özelliğine sahiptir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirachetronic/magec is public and reachablegithub.com/achetronic/magec ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-08github.com/achetronic/magec ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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