Flomo MCP Server
项目简介
Flomo MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它充当 AI 聊天工具(如 Cursor、Claude 等 MCP 客户端)和 Flomo 笔记应用之间的桥梁。通过这个服务器,用户可以直接在 AI 聊天对话中使用自然语言命令,将对话内容或想法保存为 Flomo 笔记,实现无缝衔接的工作流。
主要功能点
- AI 聊天内容转 Flomo 笔记: 允许用户在与 AI 聊天时,通过简单的指令将重要的信息、对话内容或产生的想法快速保存到 Flomo 笔记中。
- 自然语言指令: 用户无需学习复杂的命令,只需在聊天中使用自然语言表达“保存到 Flomo”的意图,服务器即可理解并执行。
- 简化笔记流程: 减少了在 AI 聊天工具和 Flomo 之间手动复制粘贴的步骤,提高了信息记录和整理的效率。
- 基于 MCP 协议: 采用标准化的 MCP 协议,确保与支持 MCP 协议的 AI 客户端(如 Cursor、Claude 等)的兼容性和互操作性。
安装步骤
本 MCP 服务器可以通过多种方式安装,以下列出推荐的安装方式:
方式一:使用 Smithery 安装 (Claude Desktop 自动安装)
如果你的 MCP 客户端是 Claude Desktop,可以使用 Smithery 快速安装:
npx -y @smithery/cli install mcp-server-flomo --client claude
方式二:使用 mcp-get 安装
如果你的 MCP 客户端支持 'mcp-get',可以使用以下命令安装:
npx @michaellatman/mcp-get@latest install mcp-server-flomo
方式三:手动安装和配置
- 安装 Node.js 环境: 确保你的电脑上已安装 Node.js 和 npm (Node.js 包管理器)。
- 安装 mcp-server-flomo: 在命令行中执行以下命令安装:
npm install mcp-server-flomo - 配置 Flomo API URL: 你需要从 Flomo API 设置 获取你的 Flomo API URL。这是一个个人访问令牌,用于服务器连接到你的 Flomo 账户。
- 启动服务器: 在命令行中,使用以下命令启动服务器,并将你的 Flomo API URL 替换 'your_api_url_here':
FLOMO_API_URL=your_api_url_here npx mcp-server-flomo
服务器配置
对于 MCP 客户端,你需要配置服务器连接信息。以下是一个典型的 JSON 格式配置示例,你需要将其添加到你的 MCP 客户端配置中。
{ "mcpServers": { "mcp-server-flomo": { // 服务器名称,客户端内唯一标识,可以自定义 "command": "npx", // 启动服务器的命令,通常为 npx "args": [ // 命令参数,指向 mcp-server-flomo 的入口文件 "mcp-server-flomo" ], "env": { // 环境变量配置 "FLOMO_API_URL": "your_api_url_here" // Flomo API URL,请替换为你在 Flomo 官网获取的 API URL } } } }
配置参数说明:
- 'mcpServers': 定义 MCP 服务器的配置,可以配置多个服务器。
- 'mcp-server-flomo': 服务器名称,用于在客户端中引用,可以自定义,建议与仓库名保持一致。
- 'command': 启动服务器的可执行命令,这里使用 'npx',它会自动查找并执行 'mcp-server-flomo' 包。
- 'args': 命令参数,这里只有一个参数 '"mcp-server-flomo"',指定要执行的包名。
- 'env': 环境变量配置,'FLOMO_API_URL' 是 'mcp-server-flomo' 服务器必需的环境变量,用于提供 Flomo API 访问令牌。 请务必将 '"your_api_url_here"' 替换为你自己的 Flomo API URL。
基本使用方法
-
启动 MCP 服务器: 按照上述安装步骤启动 'mcp-server-flomo' 服务器。
-
配置 MCP 客户端: 将上述服务器配置 JSON 添加到你的 MCP 客户端(如 Cursor、Claude 等)的服务器配置中,并确保配置正确。
-
在 AI 聊天中使用指令: 在与 AI 聊天时,你可以使用自然语言指令,例如:
"如何发布一个 mcp 服务器?请在回答后将答案保存到 flomo 笔记"当 AI 客户端识别到 “保存到 flomo 笔记” 这样的意图时,就会调用 'mcp-server-flomo' 服务器的 'newNote' 工具,将 AI 的回复内容发送到 Flomo 进行保存。
-
查看 Flomo 笔记: 保存成功后,你可以在你的 Flomo 应用中查看到新创建的笔记。
示例对话:
<img src="https://raw.githubusercontent.com/xianminx/mcp-server-flomo/refs/heads/main/public/images/mcp-cursor-flomo.png" width="400">在这个例子中,用户询问了一个问题,并指示将答案保存到 Flomo。Cursor AI Agent (MCP 客户端) 会将问题发送给 LLM 获取答案,然后调用 'mcp-server-flomo' 服务器的 'newNote' 工具,将 LLM 的答案作为笔记保存到用户的 Flomo 账户中。
信息
分类
生产力应用