MCP-Flomo-Server

MCP-Flomo-Server

プロジェクト概要

MCP-Flomo-Server は、Model Context Protocol（MCP）に基づくサーバーアプリケーションで、AI アシスタント（Claude など）から Flomo ノートアプリに直接コンテンツを記録できます。このサービスを使うと、AI との会話中に価値ある情報を簡単に Flomo に保存できます。

主な機能

• MCP ツールインターフェースを提供し、AI アシスタントから直接呼び出せます
• Flomo API を通じて、ユーザーの Flomo アカウントにコンテンツを送信します
• 環境変数による設定に対応し、個別の設定が可能です
• TypeScript で開発されており、型安全性を提供します

インストール

前提条件

• Node.js（v16 以降）
• npm または yarn
• Flomo API キー（Flomo のウェブ版で取得）

インストール手順

1. リポジトリをクローンします

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

2. 依存関係をインストールします

npm install

3. Flomo API を設定します

src/index.ts ファイル内の flomo_api 変数の値を直接変更します。

let flomo_api = ""

使用方法

プロジェクトをビルドする

npm run build

AI アシスタントで使用する

サーバーの実行後、AI アシスタントは MCP プロトコルを通じて flomo ツールを呼び出し、Flomo アカウントにコンテンツを記録できます。

呼び出し例：

记录到 Flomo: "这是一条测试笔记"

技術スタック

• TypeScript
• Node.js
• Model Context Protocol SDK
• Zod（データ検証用）

プロジェクト構成

├── src/
│   └── index.ts      # 主要服务器代码
├── build/            # 编译后的 JavaScript 文件
├── package.json      # 项目依赖和脚本
└── tsconfig.json     # TypeScript 配置

ライセンス

ISC

貢献ガイド

このプロジェクトの改善に向けた Issues や Pull Requests を歓迎します。

よくある質問

Q: Flomo API キーはどのように取得できますか？
A: Flomo のウェブ版にログインし、設定から API オプションを見つけて、新しい API キーを作成してください。

Q: サーバーの起動後、何も出力されないのは正常ですか？
A: はい。サーバーは起動後、MCP クライアントからの接続を待機するため、コンソールに追加の出力がないのは正常です。

Q: サーバーが正常に動作していることを確認するにはどうすればよいですか？
A: AI アシスタントを使って Flomo にノートを送信し、Flomo アカウントにそのノートが届いているか確認してください。