使用说明

项目简介

本项目 'mcp-server-flomo' 是一个基于 Model Context Protocol (MCP) 构建的服务器，它扩展了 LLM 应用的功能，使其能够与 Flomo 笔记应用进行集成。通过此 MCP 服务器，LLM 客户端可以调用预设的工具，将文本内容作为笔记快速发送到用户的 Flomo 账户中。

主要功能点

笔记写入工具 (write_note): 提供一个名为 'write_note' 的工具，允许 LLM 客户端请求服务器将指定的文本内容添加到用户的 Flomo 笔记应用中。
Flomo 集成: 专为 Flomo 用户设计，通过简单的配置即可将 LLM 的能力与个人 Flomo 知识库连接起来。
易于安装和配置: 提供清晰的安装和配置指南，方便用户快速部署和使用。

安装步骤

前提条件: 确保您的电脑已安装 Node.js 和 npm (通常 Node.js 安装包会自带 npm)。

克隆仓库: 打开终端或命令提示符，执行以下命令克隆仓库到本地：

git clone https://github.com/chatmcp/mcp-server-flomo.git

进入仓库目录: 使用 'cd' 命令进入克隆下来的仓库目录：
```
cd mcp-server-flomo
```
安装依赖: 在仓库目录下，运行 npm 命令安装项目所需的依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 'mcp-server-flomo' 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件。以 Claude Desktop 为例，配置文件通常位于：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

打开 'claude_desktop_config.json' 文件，在 'mcpServers' 字段中添加以下配置信息。如果 'mcpServers' 字段不存在，请手动创建。

{
  "mcpServers": {
    "mcp-server-flomo": {
      "command": "npx",
      "args": ["-y", "@chatmcp/mcp-server-flomo"],
      "env": {
        "FLOMO_API_URL": "YOUR_FLOMO_API_URL"  // 请替换为你的 Flomo API URL
      }
    }
  }
}

配置参数说明:

'server name': 'mcp-server-flomo' - 服务器的名称，用于在客户端中标识。
'command': 'npx' - 用于执行 Node.js 包的命令。
'args': '["-y", "@chatmcp/mcp-server-flomo"]' - 启动服务器的参数，'-y' 参数用于自动确认安装 '@chatmcp/mcp-server-flomo' 包（如果尚未安装）。
'env': 环境变量配置。
- 'FLOMO_API_URL': 必须配置。这是您的 Flomo API URL，用于服务器连接到您的 Flomo 账户。您可以在 Flomo 个人设置页面找到 "Incoming Webhook" 并获取 API URL。请将 'YOUR_FLOMO_API_URL' 替换为您实际的 API URL。

基本使用方法

启动 MCP 客户端: 配置完成后，启动您的 MCP 客户端（如 Claude Desktop）。客户端会自动加载并连接到 'mcp-server-flomo' 服务器。
调用 'write_note' 工具: 在 MCP 客户端中，您可以指示 LLM 使用 'write_note' 工具来记录笔记。例如，您可以向 LLM 发出指令，如：
- "使用 write_note 工具记录一条笔记，内容是：今天学习了 MCP 服务器的配置。"
- "请使用 write_note 工具帮我写一个 Flomo 笔记，内容为：会议纪要：...（会议内容）"
查看 Flomo 笔记: 服务器成功执行工具后，笔记内容将被发送到您的 Flomo 账户。您可以登录 Flomo 应用查看新添加的笔记。

关键词