Letta MCP 服务器

提供代理管理、内存操作以及与 Letta 系统集成的工具的服务器。

快速设置

选项 1：使用 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

选项 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 获取代理详细信息	代理 ID	-
`modify_agent`	更新现有代理	agent_id，更新数据	-
`delete_agent`	删除代理	代理 ID	-
`clone_agent`	克隆现有代理	源代理 ID、新代理名称	override_existing_tools，项目 ID
`bulk_delete_agents`	删除多个代理	-	代理 ID、代理名称过滤器、代理标签过滤器

内存管理

工具	描述	必需参数	可选参数
`list_memory_blocks`	列出所有内存块	-	过滤器、agent_id、页面、页面大小、标签
`create_memory_block`	创建新的内存块	名称、标签、值	agent_id，元数据
`read_memory_block`	读取内存块	区块 ID	代理 ID
`update_memory_block`	更新内存块	区块 ID	值、元数据、agent_id
`attach_memory_block`	将内存附加到代理	block_id、agent_id	标签

刀具管理

工具	描述	必需参数	可选参数
`list_tools`	列出所有可用的工具	-	过滤器、页面、页面大小
`list_agent_tools`	列出特定代理的工具	代理 ID	-
`attach_tool`	将工具附加到代理	代理 ID	工具 ID、工具 ID、工具名称
`upload_tool`	上传新工具	名称、描述、源代码	类别，代理ID
`bulk_attach_tool_to_agents`	将一个工具附加到多个代理	工具 ID	代理名称过滤器、代理标签过滤器

其他工具

模型管理： 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

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

使用 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
}

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

MCP 服务器实现，可与 Letta API 交互，以管理 Letta 系统中的代理、内存块和工具。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Tana MCP Server
tim-mcdonnell
A
security
A
license
A
quality
An MCP server that connects to Tana's Input API, allowing Large Language Models and other MCP clients to create and manipulate data in Tana workspaces.
Last updated -
11
13
19
TypeScript
MIT License
Superset MCP Integration
aptro
-
security
A
license
-
quality
MCP server enabling AI agents to programmatically connect to and control Apache Superset instances, allowing users to manage dashboards, charts, databases, datasets, and run SQL queries through natural language interactions.
Last updated -
20
Python
MIT License
Linear
tacticlaunch
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
Last updated -
32
80
5
TypeScript
MIT License
Agentforce MCP Server
xlengelle-sf
-
security
-
license
-
quality
This MCP server provides tools to interact with the Salesforce Agentforce API, allowing authentication, session creation, and message exchange with Salesforce agents.
Last updated -
1
Python

View all related MCP servers

Letta MCP Server