文档

MCP 集成

MCP 集成

MCP(模型上下文协议)让 Memo 连接到外部工具服务器和资源系统。

通过 CLI 管理 MCP#

列出和检查

memo mcp list
memo mcp list --json
memo mcp get <name>
memo mcp get <name> --json

添加服务器

添加本地 stdio 服务器:

memo mcp add local_tools -- /path/to/mcp-server --flag

添加远程 streamable HTTP 服务器:

memo mcp add remote --url https://your-mcp-server.com/mcp --bearer-token-env-var MCP_TOKEN

对于 stdio 服务器,可以使用重复的 --env KEY=VALUE 传递环境变量。

移除服务器

memo mcp remove <name>

帮助

memo mcp help

登录/注销命令

memo mcp login <name> [--scopes read,write]
memo mcp logout <name>

streamable_http 服务器支持 OAuth 登录/注销。 memo mcp list 同时会输出每个服务器的 auth_status

  • unsupported
  • not_logged_in
  • bearer_token
  • oauth

手动 `config.toml` 示例#

本地 Stdio MCP

[mcp_servers.local_tools]
command = "/path/to/mcp-server"
args = ["--flag"]
# 可选:
# env = { API_TOKEN = "..." }
# stderr = "inherit"

远程 Streamable HTTP MCP

[mcp_servers.remote]
type = "streamable_http"
url = "https://your-mcp-server.com/mcp"
bearer_token_env_var = "MCP_TOKEN"
# 可选:
# http_headers = { "X-Team" = "platform" }

在 TUI 中查看 MCP#

使用斜杠命令:

/mcp

它显示为当前会话配置的 MCP 服务器。

在 Web UI 中管理 MCP#

memo web 模式下,可从侧边栏进入 MCP Servers 页面进行:

  • 创建 / 编辑 / 删除 server
  • 对支持 OAuth 的远程 server 登录 / 登出
  • 切换默认激活状态

配置更改何时生效#

MCP 服务器在创建会话时加载。

添加/更新/移除 MCP 配置后:

  • 重启 memo,或
  • 开始新会话(/new

常见问题#

  • memo mcp list 有条目但 /mcp 看起来陈旧:重新创建会话。
  • 远程服务器认证失败:检查当前 shell 中是否存在 token 环境变量。
  • 本地服务器启动失败:验证 commandargs 和可执行路径。