Letta-MCP-服务器

@oculairmedia/Letta-MCP-server

0 Stars 366 次浏览 oculairmedia 更新于 2026-08-23

一种MCP服务器实现，它 enables 与Letta API的交互，以在Letta系统中管理代理、内存块和工具。（注：原文中的“enables”可依据语境调整为更合适的中文表达，如“允许”或“支持”，以下是优化版翻译：）一种MCP服务器实现，支持通过Letta API在Letta系统中管理代理、内存块和工具。

知识管理与记忆开发者工具

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

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/ - 服务器传输实现（标准输入输出和SSE）

可用工具

代理管理

工具	描述	必需参数	可选参数
`create_agent`	创建一个新的Letta代理	name, description	model, embedding
`list_agents`	列出所有可用代理	-	filter
`prompt_agent`	向代理发送消息	agent_id, message	-
`get_agent`	通过ID获取代理详情	agent_id	-
`modify_agent`	更新现有代理	agent_id, update_data	-
`delete_agent`	删除代理	agent_id	-
`clone_agent`	克隆现有代理	source_agent_id, new_agent_name	override_existing_tools, project_id
`bulk_delete_agents`	删除多个代理	-	agent_ids, agent_name_filter, agent_tag_filter

内存管理

工具	描述	必需参数	可选参数
`list_memory_blocks`	列出所有内存块	-	filter, agent_id, page, pageSize, label
`create_memory_block`	创建新的内存块	name, label, value	agent_id, metadata
`read_memory_block`	读取内存块	block_id	agent_id
`update_memory_block`	更新内存块	block_id	value, metadata, agent_id
`attach_memory_block`	将内存附加到代理	block_id, agent_id	label

工具管理

工具	描述	必需参数	可选参数
`list_tools`	列出所有可用工具	-	filter, page, pageSize
`list_agent_tools`	列出特定代理的工具	agent_id	-
`attach_tool`	将工具附加到代理	agent_id	tool_id, tool_ids, tool_names
`upload_tool`	上传新工具	name, description, source_code	category, agent_id
`bulk_attach_tool_to_agents`	将工具附加到多个代理	tool_id	agent_name_filter, agent_tag_filter

额外工具

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

查看源码项目主页