MEMGRAPH-MCP
Agentensystem
Ein dauerhafter Multi-Agenten-Orchestrator mit:
expliziten Laufgraphen und Checkpoint/Resume-Funktionen
orchestrator-gesteuerter paralleler Delegation
begrenzter Ausführung von Forschungsschwärmen
Schleifen für Programmierung, Überprüfung, Reparatur, CI und Genehmigung
Projektgedächtnis in Backing-Stores, die über MCP-Ressourcen und -Tools bereitgestellt werden
einem echten SQLite-Vektorindex für den Gedächtnisabruf
einem erweiterbaren externen Forschungs-Backend mit Tavily-Unterstützung
Umfang
Diese Implementierung zielt auf die MCP 2025-11-25 Spezifikationsbasis mit dem offiziellen Python MCP SDK und einem FastMCP-Server für die Gedächtnisschnittstelle ab. Für die lokale Entwicklung läuft sie über stdio. Für die Remote-Bereitstellung siehe docs/remote_auth.md.
Related MCP server: ellmos-homebase-mcp
Layout
app/runtime: Laufzustand, Scheduler, Orchestrator-Schleife, Checkpointingapp/planner: Hilfsprogramme für Planung und Graph-Revisionapp/agents: Knotenausführer für Forschung, Code, Überprüfung, Reparatur, CI, Synthese, Genehmigungapp/memory: SQLite-gestütztes Gedächtnis, Abruf und Artefakt-Indexapp/mcp_server:FastMCP-Ressourcen, Tools, Prompts und Server-Einstiegspunkttests: Abnahme- und Unit-Abdeckung
Lokale Verwendung
uv sync --group dev
uv run pytest
uv run agent-system-mcpAbruf- und Forschungs-Backends
Gedächtniseinträge werden mithilfe von
sqlite-vecin eine lokale SQLite-Vektortabelle indiziert.Der Standard-Embedding-Anbieter ist
auto: Er bevorzugt ein echtessentence-transformers-Modell und greift nur dann auf den deterministischen Hash-Anbieter zurück, wenn das Modell nicht geladen werden kann.Die Forschung verwendet ein In-Memory-Korpus-Backend, wenn ein Knoten
inputs.corpusbereitstellt.Wenn
TAVILY_API_KEYgesetzt ist, können korpusfreie Forschungsknoten das Tavily-Backend für externe Web-Recherchen nutzen.Wenn weder ein Korpus noch ein Tavily-Schlüssel verfügbar sind, liefert die Forschung begrenzte leere Ergebnisse, anstatt Quellen zu erfinden.
Embedding-Konfiguration
AGENT_SYSTEM_EMBEDDING_PROVIDER=auto|sentence-transformers|hashAGENT_SYSTEM_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2AGENT_SYSTEM_EMBEDDING_CACHE_DIR=/path/to/cacheAGENT_SYSTEM_EMBEDDING_LOCAL_ONLY=true|false
Beispiel:
AGENT_SYSTEM_EMBEDDING_PROVIDER=sentence-transformers uv run agent-system create-run "improve scheduler"Lokaler Transport
Die Entwicklung verwendet den MCP stdio-Transport.
Remote-Bereitstellung
Die Remote-Bereitstellung ist in v1 absichtlich nur dokumentationsbasiert. Der Server dokumentiert einen OAuth 2.1-kompatiblen Zustimmungspfad und behält lokales stdio als Standard-Entwicklungsmodus bei.
Vollständige Dokumentation
state.md: aktueller Projektstatus, Änderungen seit Erstellung und Roadmap
docs/getting_started.md: schnellster Weg zu einem funktionierenden lokalen Lauf und MCP-Server
docs/operator_guide.md: vollständiger Systemüberblick, Betrieb und Best Practices
docs/developer_custom_graphs.md: Python API-Nutzung, benutzerdefiniertes Graph-Design und Knoten-Payload-Referenz
docs/codex_mcp_usage.md: wie Codex dieses MCP für die Planung großer Anwendungen, das Gedächtnis und die Checkpoint-Ausführung nutzen sollte
examples/plan_large_app.py: Beispiel für die programmgesteuerte Erstellung eines Blueprints und Laufs für eine große Anwendung
Available Tools
10 toolscheckpoint_runBIdempotent
Apply a small state patch and create an explicit checkpoint.
Inputs: run_id (required), state_patch_json (required). Returns: object
create_runA
Create a new orchestrator run from a high-level goal and optional JSON spec.
Inputs: goal (required), spec_json. Returns: object
get_file_contextBRead-onlyIdempotent
Read file context from the orchestrator workspace.
Inputs: paths (required), include_neighbors. Returns: object
plan_goalBRead-onlyIdempotent
Generate a large-app execution blueprint from a high-level goal and optional JSON spec.
Inputs: goal (required), spec_json. Returns: object
record_decisionCIdempotent
Record a high-value architectural or implementation decision.
Inputs: title (required), run_id (required), node_id (required), rationale (required), +2 more. Returns: object
record_failure_modeAIdempotent
Record a reusable failure pattern or bug signature.
Inputs: run_id (required), node_id (required), summary (required), signature (required), +1 more. Returns: object
resume_runAIdempotent
Resume an orchestrator run until completion, pause, or failure.
Inputs: run_id (required). Returns: object
search_project_memoryARead-onlyIdempotent
Search project memory by query string and optional type filters.
Inputs: query (required), kind, limit, status. Returns: result
write_project_memoryCIdempotent
Write a durable memory entry with provenance to the backing store.
Inputs: key (required), kind (required), run_id (required), node_id (required), +5 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools target distinct actions or resources, but plan_goal and create_run both take a high-level goal and optional JSON spec, making their boundaries unclear. Similarly, search_project_memory and list_related_artifacts both retrieve stored information in overlapping ways. Descriptions help clarify intent, but some pairs could still lead to misselection.
All tools follow a consistent verb_noun snake_case pattern, such as resume_run, write_project_memory, record_decision, and create_run. The naming is uniform and predictable across the entire toolset.
Ten tools is a well-scoped count for an orchestrator and memory management server. Each tool covers a meaningful operation without the set feeling bloated or overly sparse.
The core lifecycle is covered: creating and resuming runs, checkpointing, planning, memory read/write, and recording decisions/failures. Minor gaps exist, such as no explicit run status/query tool or delete operation for memory entries, but agents can generally work within the provided surface.
Maintenance
Related MCP Connectors
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Persistent, inspectable memory for AI agents with lineage, correction, and a hosted MCP endpoint.
The AI orchestration agent for modern software teams.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceShared memory and orchestration for coding agents, enabling persistent knowledge, multi-agent coordination, and a canonical workflow across MCP-compatible AI clients.83-

ellmos-homebase-mcpofficial
AlicenseCqualityBmaintenanceEnables local-first LLM orchestration with persistent memory, knowledge management, routing, swarm patterns, API probing, tests, automation planning, and plugin discovery via a stdio MCP server, using SQLite for offline storage.51173 npm2MIT- AlicenseNot gradedqualityDmaintenanceA production-grade multi-agent workflow orchestrator built on the Model Context Protocol, featuring planner/executor/critic agents, durable run state, and replayable traces.15MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous multi-agent orchestration using directed acyclic graph workflows to interact with external developer infrastructure such as Git, Postgres, and Docker through safety-gated MCP servers.Apache 2.0