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

方式三:手动安装和配置

  1. 安装 Node.js 环境: 确保你的电脑上已安装 Node.js 和 npm (Node.js 包管理器)。
  2. 安装 mcp-server-flomo: 在命令行中执行以下命令安装:
    npm install mcp-server-flomo
  3. 配置 Flomo API URL: 你需要从 Flomo API 设置 获取你的 Flomo API URL。这是一个个人访问令牌,用于服务器连接到你的 Flomo 账户。
  4. 启动服务器: 在命令行中,使用以下命令启动服务器,并将你的 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。

基本使用方法

  1. 启动 MCP 服务器: 按照上述安装步骤启动 'mcp-server-flomo' 服务器。

  2. 配置 MCP 客户端: 将上述服务器配置 JSON 添加到你的 MCP 客户端(如 Cursor、Claude 等)的服务器配置中,并确保配置正确。

  3. 在 AI 聊天中使用指令: 在与 AI 聊天时,你可以使用自然语言指令,例如:

    "如何发布一个 mcp 服务器?请在回答后将答案保存到 flomo 笔记"

    当 AI 客户端识别到 “保存到 flomo 笔记” 这样的意图时,就会调用 'mcp-server-flomo' 服务器的 'newNote' 工具,将 AI 的回复内容发送到 Flomo 进行保存。

  4. 查看 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 账户中。

信息

分类

生产力应用