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

Related MCP server: A2A Client MCP Server

Estructura del directorio

index.js - Punto de entrada principal
core/ - Funcionalidad principal del servidor
tools/ - Implementaciones de herramientas individuales
transports/ - 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
}