Furi

🚀 🍃 Furikake（または furi）（開発中）

Furikake は、MCP サーバーの管理と実行を行うための使いやすいローカル CLI および API です。このツールにより、MCP サーバーの操作が簡単になります。

• GitHub から MCP サーバーをダウンロード [サンプルリンク]
• Smithery.yaml 検出（または自動検出/実行処理）
• 全機能 CLI [ナノ - スピナーを使用し、読みやすさを向上]
• TypeScript と JavaScript の MCP をサポート
• Python ベースの MCP は重要なロードマップ項目（近日サポート予定）
• HTTP API ルート（Bun http を使用し、stdio を http に変換、明確かつ標準的なルート）
• ポートと sudo ルートの可視性を柔軟に設定
• すべての実行中の MCP と各プロセスのログを表示
• プロセス状態管理 PM2 を使用
• Bun と TypeScript で構築
• ご飯と相性が良い

🚀 クイックスタート

📦 インストール

macOS/Linux

まず、Bun をインストールします（まだインストールされていない場合）。

curl -fsSL https://bun.sh/install | bash

次に、Furikake をインストールします。

curl -fsSL https://furikake.github.io/install.sh | bash

インストールが完了したら、furi --version を入力して、インストールが成功したかどうかを確認します。

💻 使用例

基本的な使用法

MCP サーバーのインストール

GitHub から MCP サーバーをインストールするには、以下のコマンドを実行します。

furi add username/repository

例えば、example-repo をインストールするには、以下のコマンドを実行します。

furi add username/example-repo

MCP サーバーの起動と停止

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

furi start mcpName

MCP サーバーを停止するには、以下のコマンドを実行します。

furi stop mcpName

MCP の状態を確認する

すべての実行中の MCP サーバーの状態を確認するには、以下のコマンドを実行します。

furi status

特定の MCP サーバーの状態を確認するには、以下のコマンドを実行します。

furi status mcpName

📚 ドキュメント

HTTP API ドキュメント

基本的な使用法

Furikake の HTTP サーバーを起動するには、以下のコマンドを実行します。

furi http start

デフォルトでは、HTTP サービスは localhost:9339 で利用できます。

公開ルート

• / - 利用可能なすべてのルートを表示
• /health - サービスの健全性を確認
• /metrics - パフォーマンス指標を提供（有効にした場合）

MCP 管理ルート

sudo ルートを使用するには、HTTP サーバーを起動するときに --sudo フラグを追加します。

furi http start --sudo

MCP のインストール

新しい MCP を POST リクエストでインストールするには、以下のコマンドを実行します。

curl -X POST http://localhost:9339/add/username/repository

MCP の起動

MCP を POST リクエストで起動し、環境変数を設定するには、以下のコマンドを実行します。

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

MCP の停止

MCP を POST リクエストで停止するには、以下のコマンドを実行します。

curl -X POST http://localhost:9339/mcpName/stop

🔧 トラブルシューティング

何らかの問題が発生した場合は、以下の点を確認してください。

⚠️ 重要提示

1. Furikake が正しくインストールされていることを確認してください。
2. HTTP サーバーが正常に起動し、エラーログがないことを確認してください。
3. furi http status を使用して、HTTP サービスの状態を確認してください。

🔮 開発ロードマップ

• 異なる Node.js バージョンをサポートし、package.json の設定に基づいて nvm を介して渡す
• Python MCP のサポートを追加
• プロジェクトのテストを完了

上記の内容は随時更新される可能性があり、具体的な機能と順序は変更される場合があります。