Letta MCP 서버
에이전트 관리, 메모리 작업, 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
디렉토리 구조
- 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
}