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가 설정된 경우, 코퍼스가 없는 연구 노드는 외부 웹 연구를 위해 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