Skip to main content
Glama

エージェントシステム

以下を備えた永続的なマルチエージェントオーケストレーター:

  • 明示的な実行グラフとチェックポイント/再開機能

  • オーケストレーターによる並列委任制御

  • 境界付きリサーチスウォーム実行

  • コーディング、レビュー、修正、CI、承認ループ

  • MCPリソースとツールを通じて公開されるバックエンドストア内のプロジェクトメモリ

  • メモリ検索のためのリアルなSQLiteベクトルインデックス

  • Tavilyサポートを備えたプラグ可能な外部リサーチバックエンド

スコープ

この実装は、公式Python MCP SDKとメモリサーフェス用のFastMCPサーバーを使用したMCP 2025-11-25 仕様ベースラインを対象としています。ローカル開発ではstdio経由で実行されます。リモートデプロイメントについては、docs/remote_auth.mdを参照してください。

Related MCP server: ellmos-homebase-mcp

レイアウト

  • app/runtime: 実行状態、スケジューラー、オーケストレーターループ、チェックポインティング

  • app/planner: プランニングおよびグラフ修正ヘルパー

  • app/agents: リサーチ、コード、レビュー、修正、CI、合成、承認のためのノードエグゼキューター

  • app/memory: SQLiteベースのメモリ、検索、およびアーティファクトインデックス

  • app/mcp_server: FastMCPリソース、ツール、プロンプト、およびサーバーエントリーポイント

  • tests: 受け入れテストおよびユニットカバレッジ

ローカルでの使用方法

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

検索およびリサーチバックエンド

  • メモリエントリーは、sqlite-vecを使用してローカルのSQLiteベクトルテーブルにインデックス化されます。

  • デフォルトの埋め込みプロバイダーはautoです。これは実際のsentence-transformersモデルを優先し、モデルがロードできない場合にのみ決定論的ハッシュプロバイダーにフォールバックします。

  • リサーチは、ノードがinputs.corpusを提供する場合、インメモリコーパスバックエンドを使用します。

  • TAVILY_API_KEYが設定されている場合、コーパスなしのリサーチノードは外部WebリサーチのためにTavilyバックエンドを使用できます。

  • コーパスもTavilyキーも利用できない場合、リサーチはソースを捏造する代わりに、境界付きの空の結果を返します。

埋め込み設定

  • 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

例:

AGENT_SYSTEM_EMBEDDING_PROVIDER=sentence-transformers uv run agent-system create-run "improve scheduler"

ローカル転送

開発にはMCP stdioトランスポートを使用します。

リモートデプロイメント

リモートデプロイメントは、v1では意図的にドキュメントのみとなっています。サーバーはOAuth 2.1互換の同意パスを文書化しており、デフォルトの開発モードとしてローカルのstdioを維持しています。

完全なドキュメント

  • state.md: 現在のプロジェクト状態、作成以降の変更点、およびロードマップ

  • docs/getting_started.md: 動作するローカル実行環境とMCPサーバーへの最短ルート

  • docs/operator_guide.md: システム全体の概要、運用、およびベストプラクティス

  • docs/developer_custom_graphs.md: Python APIの使用方法、カスタムグラフの設計、およびノードペイロードのリファレンス

  • docs/codex_mcp_usage.md: 大規模アプリのプランニング、メモリ、チェックポイント実行のためにCodexがこのMCPをどのように使用すべきか

  • examples/plan_large_app.py: 大規模アプリのブループリントを生成し、プログラムで実行する例

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