Letta MCP 서버

Name: Letta MCP Server
Author: oculairmedia

에이전트 관리, 메모리 작업, Letta 시스템과의 통합을 위한 도구를 제공하는 서버입니다.

빠른 설정

옵션 1: Node.js로 실행

지엑스피1

옵션 2: Docker로 실행

# Build and run locally docker build -t letta-mcp-server . docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp letta-mcp-server # Or use the public image docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest

Related MCP server: A2A Client MCP Server

디렉토리 구조

index.js - 주요 진입점
core/ - 핵심 서버 기능
tools/ - 개별 도구 구현
transports/ - 서버 전송 구현(stdio 및 SSE)

사용 가능한 도구

에이전트 관리

도구	설명	필수 매개변수	선택적 매개변수
`create_agent`	새로운 Letta 에이전트 만들기	이름, 설명	모델, 임베딩
`list_agents`	사용 가능한 모든 에이전트를 나열하세요	-	필터
`prompt_agent`	상담원에게 메시지 보내기	agent_id, 메시지	-
`get_agent`	ID로 에이전트 세부 정보 가져오기	에이전트_아이디	-
`modify_agent`	기존 에이전트 업데이트	agent_id, update_data	-
`delete_agent`	에이전트 삭제	에이전트_아이디	-
`clone_agent`	기존 에이전트 복제	소스_에이전트_ID, 새_에이전트_이름	기존 도구 재정의, 프로젝트 ID
`bulk_delete_agents`	여러 에이전트 삭제	-	에이전트 ID, 에이전트 이름 필터, 에이전트 태그 필터

메모리 관리

도구	설명	필수 매개변수	선택적 매개변수
`list_memory_blocks`	모든 메모리 블록 나열	-	필터, 에이전트 ID, 페이지, 페이지 크기, 레이블
`create_memory_block`	새로운 메모리 블록을 만듭니다	이름, 라벨, 값	agent_id, 메타데이터
`read_memory_block`	메모리 블록 읽기	블록_아이디	에이전트_아이디
`update_memory_block`	메모리 블록 업데이트	블록_아이디	값, 메타데이터, agent_id
`attach_memory_block`	에이전트에 메모리 첨부	블록_아이디, 에이전트_아이디	상표

도구 관리

도구	설명	필수 매개변수	선택적 매개변수
`list_tools`	사용 가능한 모든 도구 나열	-	필터, 페이지, 페이지 크기
`list_agent_tools`	특정 에이전트를 위한 도구 나열	에이전트_아이디	-
`attach_tool`	에이전트에 도구 첨부	에이전트_아이디	도구_ID, 도구_ID, 도구_이름
`upload_tool`	새로운 도구 업로드	이름, 설명, 소스 코드	카테고리, agent_id
`bulk_attach_tool_to_agents`	여러 에이전트에 도구 연결	도구_아이디	에이전트 이름 필터, 에이전트 태그 필터

추가 도구

모델 관리 : list_llm_models , list_embedding_models
아카이브 관리 : list_passages , create_passage , modify_passage , delete_passage
MCP 서버 관리 : list_mcp_servers , list_mcp_tools_by_server
가져오기/내보내기 : export_agent , import_agent

도커 운영

# View container logs docker logs -f letta-mcp # Stop the container docker stop letta-mcp # Update to latest version docker pull ghcr.io/oculairmedia/letta-mcp-server:latest docker stop letta-mcp docker rm letta-mcp docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest

MCP 설정을 사용한 구성

mcp_settings.json에 서버를 추가합니다.

"letta": { "command": "node", "args": [ "--no-warnings", "--experimental-modules", "path/to/letta-server/index.js" ], "env": { "LETTA_BASE_URL": "https://your-letta-instance.com", "LETTA_PASSWORD": "yourPassword" }, "disabled": false, "alwaysAllow": [ "upload_tool", "attach_tool", "list_agents", "list_memory_blocks" ], "timeout": 300 }

원격 인스턴스의 경우 URL 구성을 사용하세요.

"remote_letta_tools": { "url": "http://your-server:3001/sse", "disabled": false, "alwaysAllow": [ "attach_tool", "list_agents", "list_tools", "get_agent" ], "timeout": 120 }