Mcp Workflowy

Workflowy MCP

Workflowy と連携するための Model Context Protocol (MCP) サーバーです。このサーバーは Workflowy への MCP 互換インターフェースを提供し、AI アシスタントがプログラムから Workflowy のリストを操作できるようにします。

MCP とは？

Model Context Protocol (MCP) は、AI モデルが外部ツールや API と連携するための標準化された方法です。このサーバーは MCP を実装しており、AI アシスタント（ChatGPT など）が定義された一連のツールを通じて Workflowy のリストを読み取り、操作できるようにします。

機能

• Workflowy 連携: ユーザー名／パスワード認証を使用して Workflowy アカウントに接続します
• MCP 互換性: Model Context Protocol を完全にサポートします
• ツール操作: Workflowy 内のノードの検索、作成、更新、および完了／未完了のマーク付けを行います

使用例:

個人的には、Workflowy をプロジェクト管理ツールとして使用しています。 エージェントに自分のノートとコードベースへのアクセスを許可すると、以下のプロンプトが役立ちます:

• 「workflowy にあるプロジェクト XYZ に関するすべてのノートを表示して」
• 「コードベースをレビューして、完了したノートをすべて完了としてマークして」
• 「このプロジェクトの workflowy 上のマイルストーンを踏まえて、次のタスクが何であるべきか提案して」

インストール

前提条件

• Node.js v18 以上
• Workflowy アカウント

クイックインストール

# Install the package globally
npm install -g mcp-workflowy

# Or use npx to run it directly
npx mcp-workflowy server start

設定

プロジェクトディレクトリに、以下の内容で .env ファイルを作成します:

WORKFLOWY_USERNAME=your_username_here
WORKFLOWY_PASSWORD=your_password_here

あるいは、サーバーの実行時にこれらの認証情報を環境変数として指定することもできます。

使用方法

サーバーの起動

# If installed globally
mcp-workflowy server start

# Using npx
npx mcp-workflowy server start

利用可能なツール

この MCP サーバーは、Workflowy と連携するための以下のツールを提供します:

1. list_nodes - Workflowy からノードのリストを取得します（ルートノード、または指定したノードの子ノード）
2. search_nodes - クエリテキストでノードを検索します
3. create_node - Workflowy に新しいノードを作成します
4. update_node - 既存のノードのテキストまたは説明を変更します
5. toggle_complete - ノードを完了または未完了としてマークします

AI アシスタントとの連携

この MCP サーバーを AI アシスタント（ChatGPT など）で使用するには:

1. 上記のとおりに MCP サーバーを起動します
2. AI アシスタントを MCP サーバーに接続します（AI アシスタントのドキュメントを参照してください）
3. AI アシスタントが Workflowy のリストを読み取り、操作できるようになります

ワンクリック

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送ってください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細は LICENSE ファイルを参照してください。