MCP Server Flomo Go

🚀 Flomo 命令行工具集

這是一個用 Go 語言開發的 Flomo 工具集合，它支持通過命令行工具和 MCP 服務器兩種方式，將筆記輕鬆發送到 Flomo，為你的筆記記錄帶來更多便利。

🚀 快速開始

本工具集支持通過命令行工具和 MCP 服務器兩種方式將筆記發送到 Flomo。你可以按照以下安裝和使用說明進行操作。

✨ 主要特性

• 📝 支持快速通過命令行創建筆記
• 🏷️ 可添加標籤功能
• 🔌 提供 MCP 服務器集成
• 📊 詳細的日誌記錄功能
• 🌈 友好的命令行界面設計

📦 安裝指南

1. 克隆代碼倉庫：

git clone https://github.com/yourusername/mcp-server-flomo-go.git
cd mcp-server-flomo-go

2. 配置環境變量：

cp .env.example .env

編輯 .env 文件，添加你的 Flomo API 地址：

FLOMO_API_URL=https://flomoapp.com/iwh/xxx/xxx

3. 編譯 CLI 工具：

go build -o mcp-server-flomo-go cmd/flomo/main.go

💻 使用示例

命令行工具

基礎用法

./flomo -c "你的筆記內容"

高級用法

• 添加標籤：

./flomo -c "筆記內容" -t "標籤1,標籤2"

• 從標準輸入讀取內容：

echo "筆記內容" | ./flomo

• 顯示詳細信息：

./flomo -c "筆記內容" -v

命令行參數說明

• -c, --content：必需，設置筆記內容
• -t, --tags：可選，設置標籤列表（用逗號分隔）
• -v, --verbose：可選，顯示詳細日誌信息
• -h, --help：顯示幫助信息

MCP 服務器

基礎用法

啟動服務器：

go run server.go

高級用法

提供的工具命令：

• write_note：寫入筆記內容
  • 參數：content（字符串）- 支持 Markdown 格式的筆記內容

📚 詳細文檔

項目結構

.
├── cmd
│   └── flomo
│       └── main.go    # 命令行工具實現文件
├── pkg
│   └── flomo
│       └── client.go  # Flomo API 客戶端實現文件
├── server.go          # MCP 服務器實現文件
├── .env              # 環境變量配置文件
└── README.md         # 本指南文檔

開發規範

1. 遵循 Go 語言代碼規範和標準庫風格
2. 使用 go fmt 格式化代碼
3. 確保所有日誌信息清晰易讀

示例輸出

筆記發送成功！🎉
創建時間：2025-04-16 00:35:06
標籤：測試
查看鏈接：https://v.flomoapp.com/mine/?memo_id=xxx

詳細信息：
- 來源：incoming_webhook
- 創建者 ID：xxx
- 響應狀態碼：0
- 響應消息：已記錄
- 總耗時：896.754667ms

注意事項

⚠️ 重要提示

請妥善保管你的 Flomo API 地址，避免洩露給他人。建議在發送大量筆記時控制頻率。如遇問題，請使用 -v 參數查看詳細日誌信息。

📄 許可證

本項目採用 MIT License 開源協議。