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가 설정된 경우, 코퍼스가 없는 연구 노드는 외부 웹 연구를 위해 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를 기본 개발 모드로 유지합니다.

전체 문서

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