MEMGRAPH-MCP
エージェントシステム
以下を備えた永続的なマルチエージェントオーケストレーター:
明示的な実行グラフとチェックポイント/再開機能
オーケストレーターによる並列委任制御
境界付きリサーチスウォーム実行
コーディング、レビュー、修正、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|hashAGENT_SYSTEM_EMBEDDING_MODEL=sentence-transformers/all-MiniLM-L6-v2AGENT_SYSTEM_EMBEDDING_CACHE_DIR=/path/to/cacheAGENT_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 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