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:
unsupportednot_logged_inbearer_tokenoauth
手动 `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 环境变量。
- 本地服务器启动失败:验证
command、args和可执行路径。