MCP Server Flomo Go

🚀 Flomo コマンドラインツールセット

このツールセットは Go 言語で開発された 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 サーバー

1. サーバーを起動します：

go run server.go

2. 提供されるツールコマンド：

• 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 のオープンソースライセンスの下で提供されています。