🍃 Furikake (or furi)

furi

furi は、MCP 管理に使いやすい CLI と API です。

• [GitHub] から MCP サーバーをダウンロード
• Smithery.yaml の検出（または実行の自動検出・処理）
• 多機能な CLI［nanospinners、読みやすさ］
• TypeScript および JavaScript の MCP に対応
• Python ベースの MCP は主要なロードマップ項目であり、今後対応予定です
• HTTP API ルート（Bun http、stdio から http への変換、明確で標準的なルートを使用）
• ポートと sudo ルートの公開範囲をカスタマイズ可能
• 実行中のすべての MCP と各プロセスのログを表示
• PM2 によるプロセス状態管理
• Bun と TypeScript で構築
• ご飯によく合います

インストール（macOS/Linux）

Furi をインストールするには、次のコマンドを実行します。

curl -fsSL https://furi.so/install | bash

次のコマンドを実行して、インストールを確認します。

furi

Furikake は内部で Bun を使用します。Bun がまだインストールされていない場合、インストールスクリプトによってインストールされます。

Furi のアップグレード

Furi を最新バージョンにアップグレードするには、次のコマンドを実行します。

furi upgrade

使い方

MCP の管理

Furikake は、次のように公開されている GitHub リポジトリであればどれでも利用できます。

furi add <author/repo>

例：furi add smithery-ai/mcp-fetch

rename コマンドを使って MCP の名前を変更することもできます。実行中の MCP は再起動されるのでご注意ください。

furi rename <old-name> <new-name>

例：furi rename smithery-ai/mcp-fetch mcp-fetch

MCP の削除

furi remove <mcpName>

例：furi remove mcp-fetch

インストール済み MCP の一覧表示

インストール済みの MCP をすべて表示します。

furi list

MCP の起動

furi start <mcpName> -e '{"name1":"value1", "name2":"value2"}'

-e env は任意で、呼び出す MCP サーバーによって異なります。

-e フラグには、有効な JSON オブジェクトを渡してください。

-e フラグを使ってサーバーを起動すると、その値は設定ファイルに保存され、次回サーバーを使用するときに再利用されます。

MCP に必要な環境変数を確認するには、次のコマンドを使います。

furi env <mcpName>

次のコマンドを使うと、任意の MCP で利用できるすべてのツールとその詳細を一覧表示できます。

furi tools <mcpName>

その後、次のコマンドでツールを呼び出せます。

ツールの呼び出し

furi call <mcpName> <toolName> '{"param1":"value1", "param2":"value2"}'

パラメーターは、有効な JSON 文字列を単一引用符で囲んで指定してください。

MCP の停止

furi stop <mcpName>

MCP の再起動

furi restart <mcpName>

実行中のすべての MCP のステータス取得

実行中のすべての MCP のステータスが表示されます。

furi status

特定の MCP のログを取得するには、次のコマンドを使います。

furi status <mcpName>

さらに多くの出力行を表示するには、-l <lines> を使います。

設定の保存先

インストール済みのすべての MCP、設定、ログは .furikake ディレクトリに保存されます。このディレクトリの場所は、次のコマンドで確認できます。

furi where

MCP Aggregator の使用

MCP Aggregator を使うと、Cursor などの任意の MCP クライアントで Furikake を利用できます。

Furi は実行中のすべての MCP からツールを収集し、アプリまたは MCP クライアントがサブスクライブできる SSE エンドポイントを通じて公開します。Aggregator は、実行中のすべての MCP からツールの一覧を自動的に作成し、MCP の起動・停止に応じて新しいツールを監視します。

SSE に対応する MCP クライアントの場合

Aggregator サーバーを起動するには、次のコマンドを実行します。

furi meta start

これにより、MCP クライアントがサブスクライブするエンドポイントも表示されます。

stdio のみをサポートする MCP クライアントの場合

SSE トランスポートに対応しておらず、stdio 接続が必要な MCP クライアントもあります。その場合は、次のコマンドを使います。

furi connect

これにより、Aggregator サーバーが stdio モードで直接起動し、MCP クライアントは stdin/stdout 経由で接続できます。サーバーは実行中の MCP からすべてのツールを集約し、stdio トランスポートを通じて利用できるようにします。

重要：このコマンドは MCP プロトコルの要件に準拠するため、JSON のみを出力します。MCP クライアントとの通信を妨げないよう、すべてのログ出力は抑制されます。

注：furi meta start とは異なり、このコマンドはフォアグラウンドで実行され、接続を直接維持します。

カスタムポートを指定できます。

furi meta start -p 9338

ポートを指定しない場合、デフォルトは 9338 です。

Aggregator を停止するには、次のコマンドを実行します。

furi meta stop

ポート設定を保持したまま Aggregator を再起動するには、次のコマンドを実行します。

furi meta restart

Aggregator サーバーのステータスを確認するには、次のコマンドを実行します。

furi meta status

さらに多くの出力行を表示するには、-l <lines> を使います。

HTTP API の使用

• 実行中の MCP には、自動的に HTTP ルートが設定されます。
• MCP のオン／オフは CLI からのみ行えます。

MCP に HTTP 経由でアクセスするには、次のコマンドでプロキシを有効にします。

furi http start

ポートを指定するには、http start -p <port> フラグを使用します。

furi http start -p 9339

ポートを指定しない場合、デフォルトで 9339 が使用されます。

ルートを無効にするには、次のコマンドを使用します。

furi http stop

HTTP API リファレンス

Furikake HTTP API は、パブリックルートとsudo ルートに分かれています。パブリックルートはデフォルトでアクセスできますが、sudo ルートは明示的に有効にする必要があります。sudo ルートを使うと、HTTP API 経由でパッケージやインスタンスを直接管理できます。

API を保護する場合は、HTTP_AUTH_TOKEN 環境変数を設定します。

export HTTP_AUTH_TOKEN=your-secret-token

または、.env ファイルに設定します。

HTTP_AUTH_TOKEN=your-secret-token

GitHub のレート制限

パッケージのインストール時に GitHub API のレート制限を回避するには、GitHub パーソナルアクセストークンを指定します。

export GITHUB_KEY=your-github-token

または、.env ファイルに設定します。

GITHUB_KEY=your-github-token

これにより、レート制限が 1 時間あたり 60 リクエストから 5,000 リクエストに増加します。GitHub の設定 > 開発者向け設定 > 個人用アクセストークンでパーソナルアクセストークンを作成できます。

API レスポンス形式

すべての API エンドポイントは、標準化された JSON レスポンス形式に従います。

• 成功レスポンス：

  {
    "success": true,
    "data": {"The response varies by endpoint"}
  }
  

• エラーレスポンス：

  {
    "success": false,
    "message": "Descriptive error message"
  }
  

HTTP メソッド

• POST - /mcpName/call/toolName および /mcpName/start エンドポイントでのみ使用します
• GET - その他すべてのエンドポイントで使用します

パブリックルート

エンドポイント	メソッド	説明	パラメーター	レスポンス形式
/list	GET	実行中の MCP を一覧表示します	すべてのインストール済み MCP を表示するには ?all=true（任意）	{"success": true, "data": ["mcpName1", "mcpName2"]}
/tools	GET	実行中のすべての MCP から利用可能なツールを一覧表示します	なし	{"success": true, "data": [{"name": "toolName", "description": "Tool description", "inputSchema": {...}, "mcpName": "mcpName"}]}
/<mcpName>/tools	GET	指定した MCP のツールを一覧表示します	なし	{"success": true, "data": [{"name": "toolName", "description": "Tool description", "inputSchema": {...}}]}
/<mcpName>/call/<toolName>	POST	MCP のツールを呼び出します	リクエスト本文に JSON 形式で指定するツールパラメーター	{"success": true, "data": {/* Tool-specific response */}}

使用例：

実行中の MCP を一覧表示します。

curl http://localhost:9339/list

オンラインのすべての MCP で利用可能なツールを表示するには、次のコマンドを使用します。

curl "http://localhost:9339/list"

オンラインのすべての MCP のツールを一覧表示します。

curl http://localhost:9339/tools

特定の MCP のツールを一覧表示します。

curl http://localhost:9339/<mcpName>/tools

ツールを呼び出します。

curl -X POST http://localhost:9339/<mcpName>/call/<toolName> -d '{"data1":"value1", "data2":"value2"}'

Sudo ルート

MCP を API で管理できる Sudo ルートを有効にするには：

furi http start --sudo

エンドポイント	メソッド	説明	パラメーター	レスポンス形式
/status	GET	すべての MCP の状態（実行中および停止中）を取得	なし	{"success": true, "data": [{"name": "mcpName", "pid": "12345", "status": "online", "cpu": "0%", "memory": "10MB", "uptime": "2h"}]}
/add/<author>/<repo>	GET	GitHub から MCP をインストール	なし	{"success": true, "data": {"installed": true, "message": "Successfully installed"}}
/<mcpName>/status	GET	特定の MCP の状態を取得	ログ行数を指定する ?lines=10（任意）	{"success": true, "data": {"name": "mcpName", "pid": "12345", "status": "online", "logs": ["log line 1", "log line 2"]}}
/<mcpName>/restart	GET	特定の MCP を再起動	なし	{"success": true, "data": {"restarted": true}}
/<mcpName>/start	POST	特定の MCP を起動	リクエスト本文に JSON 形式で環境変数を指定	{"success": true, "data": {"started": true}}
/<mcpName>/stop	GET	特定の MCP を停止	なし	{"success": true, "data": {"stopped": true}}
/<mcpName>/rename	GET	特定の MCP の名前を変更	?newName=<newName>（必須）	{"success": true, "message": "Renamed from oldName to newName"} または {"success": false, "message": "Error message"}
/<mcpName>/remove	GET	特定の MCP を削除	なし	{"success": true, "data": {"removed": true}}
/<mcpName>/env	GET	特定の MCP の環境変数を取得	なし	{"success": true, "data": {"variables": ["key1", "key2"]}}

使用例：

すべての MCP の状態を取得：

curl http://localhost:9339/status

MCP をインストール：

curl http://localhost:9339/add/<author>/<repo>

特定の MCP の状態とログを取得：

curl "http://localhost:9339/<mcpName>/status?lines=20"

環境変数を指定して MCP を起動：

curl -X POST http://localhost:9339/<mcpName>/start -d '{"API_KEY":"your-api-key-here"}'

MCP を再起動：

curl http://localhost:9339/<mcpName>/restart

MCP を停止：

curl http://localhost:9339/<mcpName>/stop

MCP の名前を変更：

curl "http://localhost:9339/<mcpName>/rename?newName=<newName>"

MCP を削除：

curl http://localhost:9339/<mcpName>/remove

HTTP API サーバーで問題が発生した場合は、furi http status を使ってデバッグできます。

締めくくり

ここまで読んでいただけたなら、Furikake が役に立ち、時間の節約になることを願っています。MCP をもっと実践的に扱うために、楽しみながら作ったものです。貢献したい場合は、お気軽に Issue またはプルリクエストを作成してください。変更を確認したうえでマージします。

良いアイデアだと思ったら、リポジトリにスターを付けてください。

Furikake をご覧いただき、ありがとうございます。