MCP Server Flomo MCP Server

🚀 mcp-server-flomo MCP 服務器

本項目可將筆記記錄到 Flomo。它是一個基於 TypeScript 的 MCP 服務器，實現了一個簡單的筆記系統。通過演示核心 MCP 概念，展示瞭如下功能：

• 把帶有 URI 和元數據的文本筆記作為資源表示。
• 提供創建新筆記的工具。
• 可生成所有存儲筆記的摘要。

✨ 主要特性

資源

• 能通過 note:// URI 列出和訪問筆記。
• 每個筆記包含標題、內容和元數據。
• 使用純文本 MIME 類型，便於進行簡單的內容訪問。

工具

• write_note：用於創建新的文本筆記。
  • 需將內容作為必填參數傳遞。
  • 會將內容發送到 Flomo API 以接收筆記內容。

提示

• summarize_notes：生成所有存儲筆記的摘要。
  • 包含所有筆記內容作為嵌入資源。
  • 返回結構化的提示，供 LLM 進行總結。

📦 安裝指南

開發環境安裝

安裝依賴

npm install

配置環境變量

1. 複製 .env.example 到 .env。
2. 更新 .env 中的 FLOMO_API_URL 為你的 Flomo API 密鑰。

構建服務器

npm run build

使用開發模式（帶自動重建）

npm run watch

與 Claude Desktop 集成安裝

要與 Claude Desktop 配合使用，需添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-flomo": {
      "command": "/path/to/mcp-server-flomo/build/index.js"
    }
  }
}

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本提供：

npm run inspector

Inspector 將提供訪問調試工具的 URL，在你的瀏覽器中打開即可。