MCP Server Flomo MCP Server

🚀 mcp-server-flomo MCP サーバー

Flomoにノートを記録します。

これはTypeScriptに基づくMCPサーバーで、シンプルなノートシステムを実装しています。主なMCPの概念をデモンストレーションすることで、以下の機能を展示します。

• リソースはURIとメタデータを持つテキストノートを表します。
• ツールは新しいノートを作成するために使用されます。
• プロンプトはすべての保存されたノートの要約を生成します。

✨ 主な機能

リソース

• note:// URI を通じてノートを一覧表示し、アクセスできます。
• 各ノートにはタイトル、内容、メタデータが含まれています。
• 単純な内容アクセスには純粋なテキストMIMEタイプを使用します。

ツール

• write_note - 新しいテキストノートを作成します。
  • 内容を必須パラメータとして渡します。
  • ノート内容を受け取るためにFlomo APIに送信します。

プロンプト

• summarize_notes - すべての保存されたノートの要約を生成します。
  • すべてのノート内容を埋め込みリソースとして含みます。
  • LLMによる要約のための構造化されたプロンプトを返します。

📦 インストール

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を提供し、ブラウザで開くことができます。

🔧 開発

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

npm install

環境変数を設定します。

1. .env.example を .env にコピーします。
2. .env の FLOMO_API_URL をあなたのFlomo APIキーに更新します。

サーバーをビルドします。

npm run build

自動再構築を伴う開発モードで使用します。

npm run watch