Skip to main content
Glama

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, Checkpointing

  • app/planner: Hilfsprogramme für Planung und Graph-Revision

  • app/agents: Knotenausführer für Forschung, Code, Überprüfung, Reparatur, CI, Synthese, Genehmigung

  • app/memory: SQLite-gestütztes Gedächtnis, Abruf und Artefakt-Index

  • app/mcp_server: FastMCP-Ressourcen, Tools, Prompts und Server-Einstiegspunkt

  • tests: Abnahme- und Unit-Abdeckung

Lokale Verwendung

uv sync --group dev
uv run pytest
uv run agent-system-mcp

Abruf- und Forschungs-Backends

  • Gedächtniseinträge werden mithilfe von sqlite-vec in eine lokale SQLite-Vektortabelle indiziert.

  • Der Standard-Embedding-Anbieter ist auto: Er bevorzugt ein echtes sentence-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.corpus bereitstellt.

  • Wenn TAVILY_API_KEY gesetzt 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|hash

  • AGENT_SYSTEM_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2

  • AGENT_SYSTEM_EMBEDDING_CACHE_DIR=/path/to/cache

  • AGENT_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

Available Tools

10 tools
checkpoint_runB
Idempotent

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_contextB
Read-onlyIdempotent

Read file context from the orchestrator workspace.

Inputs: paths (required), include_neighbors. Returns: object

plan_goalB
Read-onlyIdempotent

Generate a large-app execution blueprint from a high-level goal and optional JSON spec.

Inputs: goal (required), spec_json. Returns: object

record_decisionC
Idempotent

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_modeA
Idempotent

Record a reusable failure pattern or bug signature.

Inputs: run_id (required), node_id (required), summary (required), signature (required), +1 more. Returns: object

resume_runA
Idempotent

Resume an orchestrator run until completion, pause, or failure.

Inputs: run_id (required). Returns: object

search_project_memoryA
Read-onlyIdempotent

Search project memory by query string and optional type filters.

Inputs: query (required), kind, limit, status. Returns: result

write_project_memoryC
Idempotent

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

    A3.5/5.0

    Scored across 10 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Shared memory and orchestration for coding agents, enabling persistent knowledge, multi-agent coordination, and a canonical workflow across MCP-compatible AI clients.
      83
      -
    • A
      license
      C
      quality
      B
      maintenance
      Enables 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.
      51
      173 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A production-grade multi-agent workflow orchestrator built on the Model Context Protocol, featuring planner/executor/critic agents, durable run state, and replayable traces.
      15
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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