MCP 服务器

Letta Agents MCP Server

通过 MCP 控制 AI 代理的创建和修改。

README

openapi-mcp-server

用于 Letta API 的模型上下文协议 (MCP) 服务器。

描述

此服务器为 API 提供模型上下文协议 (MCP) 接口。

安装

安装依赖项：

npm install

基于 .env.example 文件创建 .env 文件：

cp .env.example .env

编辑 .env 文件，添加您的 API 配置和授权详细信息。

配置

以下环境变量可以在 .env 文件中配置：

API_BASE_URL: API 的基本 URL（必需）
SERVER_NAME: MCP 服务器的名称（默认值："openapi-mcp-server"）
SERVER_VERSION: MCP 服务器的版本（默认值："1.0.0"）
DEBUG: 启用调试日志记录（true/false）（默认值：false）

使用

运行服务器

服务器提供 JavaScript 和 TypeScript 两种版本：

# 运行 JavaScript 版本
npm start

# 或者运行 TypeScript 版本（即时编译）
npm run start:ts

构建 TypeScript 版本

npm run build
cd dist
node server.js

用作 MCP 工具提供程序

此服务器实现了模型上下文协议 (MCP)，可以与任何 MCP 兼容的消费者一起使用，例如 Claude.js 客户端或其他 MCP 消费者。

从 Claude.js 客户端连接到此服务器的示例：

import { MCP } from "claude-js";
import { createStdio } from "claude-js/mcp";

// 创建 stdin/stdout 传输
const transport = createStdio({ command: "node path/to/server.js" });

// 连接到 MCP 服务器
const mcp = new MCP({ transport });
await mcp.connect();

// 列出可用工具
const { tools } = await mcp.listTools();
console.log("Available tools:", tools);

// 调用工具
const result = await mcp.callTool({
    id: "TOOL-ID",
    arguments: { param1: "value1" }
});
console.log("Tool result:", result);

可用工具

此 MCP 服务器提供以下工具：

delete_tool

ID: DELETE-v1-tools-tool-id
描述: 按名称删除工具
方法: DELETE
路径: /v1/tools/{tool_id}

参数:

tool_id: tool_id 参数（必需）
user_id: user_id 参数

retrieve_tool

ID: GET-v1-tools-tool-id
描述: 按 ID 获取工具
方法: GET
路径: /v1/tools/{tool_id}

参数:

tool_id: tool_id 参数（必需）
user_id: user_id 参数

modify_tool

ID: PATCH-v1-tools-tool-id
描述: 更新现有工具
方法: PATCH
路径: /v1/tools/{tool_id}

参数:

tool_id: tool_id 参数（必需）
user_id: user_id 参数

list_tools

ID: GET-v1-tools-
描述: 获取用户所属组织的代理可用的所有工具的列表
方法: GET
路径: /v1/tools/

参数:

after: after 参数
limit: limit 参数
name: name 参数
user_id: user_id 参数

create_tool

ID: POST-v1-tools-
描述: 创建新工具
方法: POST
路径: /v1/tools/

参数:

user_id: user_id 参数

upsert_tool

ID: PUT-v1-tools-
描述: 创建或更新工具
方法: PUT
路径: /v1/tools/

参数:

user_id: user_id 参数

add_base_tools

ID: POST-v1-tools-add-base-tools
描述: 插入/更新基本工具
方法: POST
路径: /v1/tools/add-base-tools

参数:

user_id: user_id 参数

run_tool_from_source

ID: POST-v1-tools-run
描述: 尝试从源代码构建工具，然后在提供的参数上运行它
方法: POST
路径: /v1/tools/run

参数:

user_id: user_id 参数

list_composio_apps

ID: GET-v1-tools-composio-apps
描述: 获取所有 Composio 应用程序的列表
方法: GET
路径: /v1/tools/composio/apps

参数:

user-id: user-id 参数

list_composio_actions_by_app

ID: GET-v1-tools-composio-apps-composio-app-name-actions
描述: 获取特定应用程序的所有 Composio 操作的列表
方法: GET
路径: /v1/tools/composio/apps/{composio_app_name}/actions

参数:

composio_app_name: composio_app_name 参数（必需）
user_id: user_id 参数

add_composio_tool

ID: POST-v1-tools-composio-composio-action-name
描述: 按操作名称添加新的 Composio 工具（Composio 将每个工具称为“操作”）
方法: POST
路径: /v1/tools/composio/{composio_action_name}

参数:

composio_action_name: composio_action_name 参数（必需）
user_id: user_id 参数

list_mcp_servers

ID: GET-v1-tools-mcp-servers
描述: 获取所有已配置的 MCP 服务器的列表
方法: GET
路径: /v1/tools/mcp/servers

参数:

user-id: user-id 参数

add_mcp_server

ID: PUT-v1-tools-mcp-servers
描述: 将新的 MCP 服务器添加到 Letta MCP 服务器配置
方法: PUT
路径: /v1/tools/mcp/servers

参数:

user_id: user_id 参数

list_mcp_tools_by_server

ID: GET-v1-tools-mcp-servers-mcp-server-name-tools
描述: 获取特定 MCP 服务器的所有工具的列表
方法: GET
路径: /v1/tools/mcp/servers/{mcp_server_name}/tools

参数:

mcp_server_name: mcp_server_name 参数（必需）
user_id: user_id 参数

add_mcp_tool

ID: POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-name
描述: 通过 MCP 服务器 + 工具名称将新的 MCP 工具注册为 Letta 服务器
方法: POST
路径: /v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}

参数:

mcp_server_name: mcp_server_name 参数（必需）
mcp_tool_name: mcp_tool_name 参数（必需）
user_id: user_id 参数

delete_mcp_server

ID: DELETE-v1-tools-mcp-servers-mcp-server-name
描述: 将新的 MCP 服务器添加到 Letta MCP 服务器配置
方法: DELETE
路径: /v1/tools/mcp/servers/{mcp_server_name}

参数:

mcp_server_name: mcp_server_name 参数（必需）
user_id: user_id 参数

retrieve_source

ID: GET-v1-sources-source-id
描述: 获取所有源
方法: GET
路径: /v1/sources/{source_id}

参数:

source_id: source_id 参数（必需）
user_id: user_id 参数

modify_source

ID: PATCH-v1-sources-source-id
描述: 更新现有数据源的名称或文档。
方法: PATCH
路径: /v1/sources/{source_id}

参数:

source_id: source_id 参数（必需）
user_id: user_id 参数

delete_source

ID: DELETE-v1-sources-source-id
描述: 删除数据源。
方法: DELETE
路径: /v1/sources/{source_id}

参数:

source_id: source_id 参数（必需）
user_id: user_id 参数

get_source_id_by_name

ID: GET-v1-sources-name-source-name
描述: 按名称获取源
方法: GET
路径: /v1/sources/name/{source_name}

参数:

source_name: source_name 参数（必需）
user_id: user_id 参数

list_sources

ID: GET-v1-sources-
描述: 列出用户创建的所有数据源。
方法: GET
路径: /v1/sources/

参数:

user_id: user_id 参数

create_source

ID: POST-v1-sources-
描述: 创建新的数据源。
方法: POST
路径: /v1/sources/

参数:

user_id: user_id 参数

upload_file_to_source

ID: POST-v1-sources-source-id-upload
描述: 将文件上传到数据源。
方法: POST
路径: /v1/sources/{source_id}/upload

参数:

source_id: source_id 参数（必需）
user_id: user_id 参数

list_source_passages

ID: GET-v1-sources-source-id-passages
描述: 列出与数据源关联的所有段落。
方法: GET
路径: /v1/sources/{source_id}/passages

参数:

source_id: source_id 参数（必需）
user_id: user_id 参数

list_source_files

ID: GET-v1-sources-source-id-files
描述: 列出与数据源关联的分页文件。
方法: GET
路径: /v1/sources/{source_id}/files

参数:

source_id: source_id 参数（必需）
limit: 要返回的文件数
after: 用于获取下一组结果的分页游标
user_id: user_id 参数

delete_file_from_source

ID: DELETE-v1-sources-source-id-file-id
描述: 删除数据源。
方法: DELETE
路径: /v1/sources/{source_id}/{file_id}

参数:

source_id: source_id 参数（必需）
file_id: file_id 参数（必需）
user_id: user_id 参数

list_agents

ID: GET-v1-agents-
描述: 列出与给定用户关联的所有代理。

此端点检索与指定用户 ID 关联的所有代理及其配置的列表。

方法: GET
路径: /v1/agents/

参数:

name: 代理的名称
tags: 用于过滤代理的标签列表
match_all_tags: 如果为 True，则仅返回与所有给定标签匹配的代理。否则，返回具有任何传入标签的代理。
before: 用于分页的游标
after: 用于分页的游标
limit: 用于分页的限制
query_text: 按名称搜索代理
project_id: 按项目 ID 搜索代理
template_id: 按模板 ID 搜索代理
base_template_id: 按基本模板 ID 搜索代理
identity_id: 按身份 ID 搜索代理
identifier_keys: 按标识符键搜索代理
include_relationships: 指定要在响应中包含哪些关系字段（例如，“tools”、“sources”、“memory”）。如果未提供，则默认加载所有关系。使用此方法可以通过减少不必要的连接来优化性能。
ascending: 是否按从旧到新 (True) 或从新到旧 (False, 默认) 对代理进行排序
user_id: user_id 参数

create_agent

ID: POST-v1-agents-
描述: 使用指定的配置创建新的代理。
方法: POST
路径: /v1/agents/

参数:

user_id: user_id 参数
X-Project: X-Project 参数

export_agent_serialized

ID: GET-v1-agents-agent-id-export
描述: 导出代理的序列化 JSON 表示形式。
方法: GET
路径: /v1/agents/{agent_id}/export

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

import_agent_serialized

ID: POST-v1-agents-import
描述: 导入序列化的代理文件并在系统中重新创建代理。
方法: POST
路径: /v1/agents/import

参数:

append_copy_suffix: 如果设置为 True，则将“_copy”附加到代理名称的末尾。
override_existing_tools: 如果设置为 True，则现有工具的源代码可能会被上传的工具定义覆盖。请注意，Letta 核心工具永远无法从外部更新。
project_id: 要将上传的代理与之关联的项目 ID。
user_id: user_id 参数

retrieve_agent_context_window

ID: GET-v1-agents-agent-id-context
描述: 检索特定代理的上下文窗口。
方法: GET
路径: /v1/agents/{agent_id}/context

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

modify_agent

ID: PATCH-v1-agents-agent-id
描述: 更新现有代理
方法: PATCH
路径: /v1/agents/{agent_id}

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

retrieve_agent

ID: GET-v1-agents-agent-id
描述: 获取代理的状态。
方法: GET
路径: /v1/agents/{agent_id}

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

delete_agent

ID: DELETE-v1-agents-agent-id
描述: 删除代理。
方法: DELETE
路径: /v1/agents/{agent_id}

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

list_agent_tools

ID: GET-v1-agents-agent-id-tools
描述: 从现有代理获取工具
方法: GET
路径: /v1/agents/{agent_id}/tools

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

attach_tool

ID: PATCH-v1-agents-agent-id-tools-attach-tool-id
描述: 将工具附加到代理。
方法: PATCH
路径: /v1/agents/{agent_id}/tools/attach/{tool_id}

参数:

agent_id: agent_id 参数（必需）
tool_id: tool_id 参数（必需）
user_id: user_id 参数

detach_tool

ID: PATCH-v1-agents-agent-id-tools-detach-tool-id
描述: 从代理分离工具。
方法: PATCH
路径: /v1/agents/{agent_id}/tools/detach/{tool_id}

参数:

agent_id: agent_id 参数（必需）
tool_id: tool_id 参数（必需）
user_id: user_id 参数

attach_source_to_agent

ID: PATCH-v1-agents-agent-id-sources-attach-source-id
描述: 将源附加到代理。
方法: PATCH
路径: /v1/agents/{agent_id}/sources/attach/{source_id}

参数:

agent_id: agent_id 参数（必需）
source_id: source_id 参数（必需）
user_id: user_id 参数

detach_source_from_agent

ID: PATCH-v1-agents-agent-id-sources-detach-source-id
描述: 从代理分离源。
方法: PATCH
路径: /v1/agents/{agent_id}/sources/detach/{source_id}

参数:

agent_id: agent_id 参数（必需）
source_id: source_id 参数（必需）
user_id: user_id 参数

list_agent_sources

ID: GET-v1-agents-agent-id-sources
描述: 获取与代理关联的源。
方法: GET
路径: /v1/agents/{agent_id}/sources

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

retrieve_agent_memory

ID: GET-v1-agents-agent-id-core-memory
描述: 检索特定代理的内存状态。此端点获取由用户 ID 和代理 ID 标识的代理的当前内存状态。
方法: GET
路径: /v1/agents/{agent_id}/core-memory

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

retrieve_core_memory_block

ID: GET-v1-agents-agent-id-core-memory-blocks-block-label
描述: 从代理检索核心内存块。
方法: GET
路径: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

参数:

agent_id: agent_id 参数（必需）
block_label: block_label 参数（必需）
user_id: user_id 参数

modify_core_memory_block

ID: PATCH-v1-agents-agent-id-core-memory-blocks-block-label
描述: 更新代理的核心内存块。
方法: PATCH
路径: /v1/agents/{agent_id}/core-memory/blocks/{block_label}

参数:

agent_id: agent_id 参数（必需）
block_label: block_label 参数（必需）
user_id: user_id 参数

list_core_memory_blocks

ID: GET-v1-agents-agent-id-core-memory-blocks
描述: 检索特定代理的核心内存块。
方法: GET
路径: /v1/agents/{agent_id}/core-memory/blocks

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

attach_core_memory_block

ID: PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-id
描述: 将核心内存块附加到代理。
方法: PATCH
路径: /v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}

参数:

agent_id: agent_id 参数（必需）
block_id: block_id 参数（必需）
user_id: user_id 参数

detach_core_memory_block

ID: PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-id
描述: 从代理分离核心内存块。
方法: PATCH
路径: /v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}

参数:

agent_id: agent_id 参数（必需）
block_id: block_id 参数（必需）
user_id: user_id 参数

list_passages

ID: GET-v1-agents-agent-id-archival-memory
描述: 检索代理的存档内存存储中的记忆（分页查询）。
方法: GET
路径: /v1/agents/{agent_id}/archival-memory

参数:

agent_id: agent_id 参数（必需）
after: 查询范围开始处的记忆的唯一 ID。
before: 查询范围结束处的记忆的唯一 ID。
limit: 响应中包含多少结果。
search: 按文本搜索段落
ascending: 是否按从旧到新 (True, 默认) 或从新到旧 (False) 对段落进行排序
user_id: user_id 参数

create_passage

ID: POST-v1-agents-agent-id-archival-memory
描述: 将记忆插入到代理的存档内存存储中。
方法: POST
路径: /v1/agents/{agent_id}/archival-memory

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

modify_passage

ID: PATCH-v1-agents-agent-id-archival-memory-memory-id
描述: 修改代理的存档内存存储中的记忆。
方法: PATCH
路径: /v1/agents/{agent_id}/archival-memory/{memory_id}

参数:

agent_id: agent_id 参数（必需）
memory_id: memory_id 参数（必需）
user_id: user_id 参数

delete_passage

ID: DELETE-v1-agents-agent-id-archival-memory-memory-id
描述: 从代理的存档内存存储中删除记忆。
方法: DELETE
路径: /v1/agents/{agent_id}/archival-memory/{memory_id}

参数:

agent_id: agent_id 参数（必需）
memory_id: memory_id 参数（必需）
user_id: user_id 参数

list_messages

ID: GET-v1-agents-agent-id-messages
描述: 检索代理的消息历史记录。
方法: GET
路径: /v1/agents/{agent_id}/messages

参数:

agent_id: agent_id 参数（必需）
after: 在其之后检索返回消息的消息。
before: 在其之前检索返回消息的消息。
limit: 要检索的最大消息数。
use_assistant_message: 是否使用助手消息
assistant_message_tool_name: 指定消息工具的名称。
assistant_message_tool_kwarg: 消息参数的名称。
user_id: user_id 参数

send_message

ID: POST-v1-agents-agent-id-messages
描述: 处理用户消息并返回代理的响应。此端点接受来自用户的消息并通过代理处理它。
方法: POST
路径: /v1/agents/{agent_id}/messages

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

modify_message

ID: PATCH-v1-agents-agent-id-messages-message-id
描述: 更新与代理关联的消息的详细信息。
方法: PATCH
路径: /v1/agents/{agent_id}/messages/{message_id}

参数:

agent_id: agent_id 参数（必需）
message_id: message_id 参数（必需）
user_id: user_id 参数

create_agent_message_stream

ID: POST-v1-agents-agent-id-messages-stream
描述: 处理用户消息并返回代理的响应。此端点接受来自用户的消息并通过代理处理它。它将始终流式传输响应的步骤，如果“stream_tokens”设置为 True，则流式传输令牌。
方法: POST
路径: /v1/agents/{agent_id}/messages/stream

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

create_agent_message_async

ID: POST-v1-agents-agent-id-messages-async
描述: 异步处理用户消息并返回运行对象。实际处理在后台进行，可以使用运行 ID 检查状态。
方法: POST
路径: /v1/agents/{agent_id}/messages/async

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

reset_messages

ID: PATCH-v1-agents-agent-id-reset-messages
描述: 重置代理的消息
方法: PATCH
路径: /v1/agents/{agent_id}/reset-messages

参数:

agent_id: agent_id 参数（必需）
add_default_initial_messages: 如果为 true，则在重置后添加默认的初始消息。
user_id: user_id 参数

create_group

ID: POST-v1-groups-
描述: 使用指定的配置创建新的多代理组。
方法: POST
路径: /v1/groups/

参数:

user_id: user_id 参数
X-Project: X-Project 参数

list_groups

ID: GET-v1-groups-
描述: 获取与查询匹配的所有多代理组。
方法: GET
路径: /v1/groups/

参数:

manager_type: 按管理器类型搜索组
before: 用于分页的游标
after: 用于分页的游标
limit: 用于分页的限制
project_id: 按项目 ID 搜索组
user_id: user_id 参数

upsert_group

ID: PUT-v1-groups-
描述: 使用指定的配置创建新的多代理组。
方法: PUT
路径: /v1/groups/

参数:

user_id: user_id 参数
X-Project: X-Project 参数

delete_group

ID: DELETE-v1-groups-group-id
描述: 删除多代理组。
方法: DELETE
路径: /v1/groups/{group_id}

参数:

group_id: group_id 参数（必需）
user_id: user_id 参数

send_group_message

ID: POST-v1-groups-group-id-messages
描述: 处理用户消息并返回组的响应。此端点接受来自用户的消息，并根据指定的模式通过组中的代理处理它
方法: POST
路径: /v1/groups/{group_id}/messages

参数:

agent_id: agent_id 参数（必需）
user_id: user_id 参数

list_group_messages

ID: GET-v1-groups-group-id-messages
描述: 检索代理的消息历史记录。
方法: GET
路径: /v1/groups/{group_id}/messages

参数:

group_id: group_id 参数（必需）
after: 在其之后检索返回消息的消息。
before: 在其之前检索返回消息的消息。
limit: 要检索的最大消息数。
use_assistant_message: 是否使用助手消息
assistant_message_tool_name: 指定消息工具的名称。
assistant_message_tool_kwarg: 消息参数的名称。
user_id: user_id 参数

send_group_message_streaming

ID: POST-v1-groups-group-id-messages-stream
描述: 处理用户消息并返回组的响应。此端点接受来自用户的消息，并根据指定的模式通过组中的代理处理它。它将始终流式传输响应的步骤，如果“stream_tokens”设置为 True，则流式传输令牌。
方法: POST
路径: /v1/groups/{group_id}/messages/stream

参数:

group_id: group_id 参数（必需）
user_id: user_id 参数

list_identities

ID: GET-v1-identities-
描述: 获取数据库中所有身份的列表
方法: GET
路径: /v1/identities/

参数:

name: name 参数
project_id: project_id 参数
identifier_key: identifier_key 参数
identity_type: identity_type 参数
before: before 参数
after: after 参数
limit: limit 参数
user_id: user_id 参数

create_identity

ID: POST-v1-identities-
描述: 向 /v1/identities/ 发出 POST 请求
方法: POST
路径: /v1/identities/

参数:

user_id: user_id 参数
X-Project: X-Project 参数

upsert_identity

ID: PUT-v1-identities-
描述: 向 /v1/identities/ 发出 PUT 请求
方法: PUT
路径: /v1/identities/

参数:

user_id: user_id 参数
X-Project: X-Project 参数

retrieve_identity

ID: GET-v1-identities-identity-id
描述: 向 /v1/identities/{identity_id} 发出 GET 请求
方法: GET
路径: /v1/identities/{identity_id}

参数:

identity_id: identity_id 参数（必需）
user_id: user_id 参数

update_identity

ID: PATCH-v1-identities-identity-id
描述: 向 /v1/identities/{identity_id} 发出 PATCH 请求
方法: PATCH
路径: /v1/identities/{identity_id}

参数:

identity_id: identity_id 参数（必需）
user_id: user_id 参数

delete_identity

ID: DELETE-v1-identities-identity-id
描述: 按其标识符键删除身份
方法: DELETE
路径: /v1/identities/{identity_id}

参数:

identity_id: identity_id 参数（必需）
user_id: user_id 参数

list_models

ID: GET-v1-models-
描述: 向 /v1/models/ 发出 GET 请求
方法: GET
路径: /v1/models/

无需参数。

list_embedding_models

ID: GET-v1-models-embedding
描述: 向 /v1/models/embedding 发出 GET 请求
方法: GET
路径: /v1/models/embedding

无需参数。

list_blocks

ID: GET-v1-blocks-
描述: 向 /v1/blocks/ 发出 GET 请求
方法: GET
路径: /v1/blocks/

参数:

label: 要包含的标签（例如，human、persona）
templates_only: 是否仅包含模板
name: 块的名称
identity_id: 按标识符 ID 搜索代理
identifier_keys: 按标识符键搜索代理
user_id: user_id 参数

create_block

ID: `POST-