Memlane

@memlane/mcp

将 Memlane（用于保存链接和笔记的个人资料库）连接到支持本地 MCP 服务的 AI 助手。

前提条件

1. 一个 Memlane 账户
2. 在应用中通过 管理 → 连接 → API 密钥 获取的 API 密钥
3. Node.js 18+（用于 npx）

配置

此服务通过 stdio 在本地运行。大多数兼容的宿主使用相同的 JSON 格式：

{
  "mcpServers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

变量	必需	默认值
MEMLANE_API_KEY	是	不适用
MEMLANE_API_URL	否	https://api.memlane.io

运行 npm install -g @memlane/mcp 后，可以使用 "command": "memlane-mcp" 代替 npx。

支持的宿主

宿主	配置位置
Cursor	设置 → MCP，或项目中的 .cursor/mcp.json
Claude Code	claude mcp add memlane -- npx -y @memlane/mcp（传入 -e MEMLANE_API_KEY=…）
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json — 见下文
Gemini CLI	~/.gemini/settings.json

对于 ChatGPT 和 Claude Desktop，请改用远程 MCP 端点（OAuth，无需 API 密钥）。

编辑配置文件后，请重启宿主应用。

VS Code

VS Code 使用 "servers" 作为根键（而不是 "mcpServers"）：

{
  "servers": {
    "memlane": {
      "command": "npx",
      "args": ["-y", "@memlane/mcp"],
      "env": {
        "MEMLANE_API_KEY": "ml_live_…"
      }
    }
  }
}

在 VS Code 设置中启用 MCP："chat.mcp.enabled": true。

ChatGPT 和远程 MCP 宿主

ChatGPT、Claude Desktop、网页端 Claude 及其他远程 MCP 客户端无法运行 npx。请改用 Memlane 托管的端点：

URL： https://api.memlane.io/mcp

1. 在你的 AI 应用中，使用该 URL 添加自定义 MCP 连接器。
2. 完成 OAuth 登录流程（Memlane 账户支持魔法链接或未来推出的社交登录方式）。
3. 在授权页面批准访问。

无需 API 密钥。要断开连接，请在 AI 应用的设置中移除该连接器。

工具

本地服务提供 10 个 MCP 工具。完整的函数参考：

• docs/TOOLS.md — 各工具的用途、参数、返回格式和工作流提示
• docs/API.md — REST 映射、身份验证范围和 curl 示例

工具	描述
search_saves	在资料库中进行语义搜索
list_saves	使用筛选条件浏览已保存内容（项目、主题、类型、状态）
get_save	获取元数据；可选获取完整 Markdown 正文
capture_url	保存 URL（后台会进行内容补充）
create_note / update_note	创建或编辑 Markdown 笔记
list_projects / list_topics	列出项目和主题
add_topic_to_save / remove_topic_from_save	为已保存内容添加或移除主题标签

安全性

API 密钥属于机密信息。请将其存储在 MCP 宿主的环境配置中。切勿将其提交到版本控制系统。若密钥泄露，请在 管理 → 连接 → API 密钥 中撤销。

许可证

MIT