Servidor Letta MCP
Un servidor que proporciona herramientas para la gestión de agentes, operaciones de memoria e integración con el sistema Letta.
Configuración rápida
Opción 1: Ejecutar con Node.js
# Development (with hot reload)
npm run dev:sse # SSE transport
# Production
npm run build # Build TypeScript first
npm run start:sse # SSE transport
Opción 2: Ejecutar con 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
Estructura del directorio
- index.js - Punto de entrada principal
core/
- Funcionalidad principal del servidortools/
- Implementaciones de herramientas individualestransports/
- Implementaciones de transporte de servidor (stdio y SSE)
Herramientas disponibles
Gestión de agentes
Herramienta | Descripción | Parámetros requeridos | Parámetros opcionales |
---|
create_agent | Crear un nuevo agente Letta | nombre, descripción | modelo, incrustación |
list_agents | Listar todos los agentes disponibles | - | filtrar |
prompt_agent | Enviar un mensaje a un agente | agent_id, mensaje | - |
get_agent | Obtener detalles del agente por ID | id del agente | - |
modify_agent | Actualizar un agente existente | id_del_agente, datos_de_actualización | - |
delete_agent | Eliminar un agente | id del agente | - |
clone_agent | Clonar un agente existente | id_del_agente_de_origen, nombre_del_nuevo_agente | anular_herramientas_existentes, id_del_proyecto |
bulk_delete_agents | Eliminar varios agentes | - | identificadores de agente, filtro de nombre de agente, filtro de etiqueta de agente |
Gestión de la memoria
Herramienta | Descripción | Parámetros requeridos | Parámetros opcionales |
---|
list_memory_blocks | Listar todos los bloques de memoria | - | filtro, agent_id, página, tamaño de página, etiqueta |
create_memory_block | Crear un nuevo bloque de memoria | nombre, etiqueta, valor | agent_id, metadatos |
read_memory_block | Leer un bloque de memoria | id_de_bloque | id del agente |
update_memory_block | Actualizar un bloque de memoria | id_de_bloque | valor, metadatos, agent_id |
attach_memory_block | Adjuntar memoria a un agente | id_de_bloque, id_de_agente | etiqueta |
Gestión de herramientas
Herramienta | Descripción | Parámetros requeridos | Parámetros opcionales |
---|
list_tools | Enumere todas las herramientas disponibles | - | filtro, página, tamaño de página |
list_agent_tools | Lista de herramientas para un agente específico | id del agente | - |
attach_tool | Adjuntar herramientas a un agente | id del agente | id_de_herramienta, id_de_herramienta, nombres_de_herramienta |
upload_tool | Subir una nueva herramienta | nombre, descripción, código fuente | categoría, id_del_agente |
bulk_attach_tool_to_agents | Adjuntar una herramienta a varios agentes | id_de_herramienta | filtro_de_nombre_del_agente, filtro_de_etiqueta_del_agente |
Herramientas adicionales
- Gestión de modelos :
list_llm_models
, list_embedding_models
- Gestión de archivos :
list_passages
, create_passage
, modify_passage
, delete_passage
- Administración del servidor MCP :
list_mcp_servers
, list_mcp_tools_by_server
- Importación/Exportación :
export_agent
, import_agent
Operaciones de Docker
# 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
Configuración con ajustes de MCP
Agregue el servidor a su 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
}
Para instancias remotas, utilice la configuración de URL:
"remote_letta_tools": {
"url": "http://your-server:3001/sse",
"disabled": false,
"alwaysAllow": [
"attach_tool",
"list_agents",
"list_tools",
"get_agent"
],
"timeout": 120
}