Fabrica MCP Stdio Bridge Server について
Fabrica MCP Stdio Bridge Serverは、Claude Desktop、Cursor、Windsurfなどのローカルstdioを使うクライアント向けに、FabricaゲートウェイのHTTP Streamableトランスポートを仲介します。ローカルの中継サーバーとして、リクエストをゲートウェイへ転送します。
主な機能
- 01ローカルstdioとゲートウェイHTTPの中継
- 02MCPリクエストをFabricaへ転送
- 03Claude、Cursor、Windsurf用インストーラー
- 04VS Code用サーバー起動コマンド
活用シーン
- 01stdioのみ対応するクライアントからFabricaゲートウェイへ接続
- 02対応クライアントにFabricaのサーバー設定を追加
MCP 対応
ローカルstdioのMCPサーバーとして動作し、HTTP Streamableトランスポート経由でリクエストをFabricaゲートウェイへ中継します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Fabrica MCP Stdio ブリッジサーバー
説明
これは、Fabrica ゲートウェイで使用される新しい MCP HTTP Streamable トランスポートにまだ対応していない Claude Desktop、Cursor、Windsurf などのクライアント向けブリッジです。ローカルホストで stdio トランスポートを使用するシム MCP サーバーを起動し、リクエストを HTTP 経由で Fabrica のゲートウェイにプロキシします。
インストール
前提条件
Fabrica ゲートウェイの UI から、一意の Toolbox ID(utbid)を取得してください。
Claude へのインストール
ターミナルを開いて、次のコマンドを実行します。
npx -y @fabrica.work/cli@latest cli install claude <utbid>
これにより、Claude の MCP 設定に次のエントリが追加されます。
~/Library/Application Support/Claude/claude_desktop_config.json
変更を反映するには、Claude デスクトップアプリを再起動してください。
Cursor へのインストール
ターミナルを開いて、次のコマンドを実行します。
npx -y @fabrica.work/cli@latest cli install cursor <utbid>
これにより、Cursor の MCP 設定に次のエントリが追加されます。
~/.cursor/mcp.json
変更を反映するには、Cursor デスクトップアプリを再起動してください。
Windsurf へのインストール
ターミナルを開いて、次のコマンドを実行します。
npx -y @fabrica.work/cli@latest cli install windsurf <utbid>
これにより、Windsurf の MCP 設定に次のエントリが追加されます。
~/.codeium/windsurf/mcp_config.json
変更を反映するには、Windsurf デスクトップアプリを再起動してください。
VSCode へのインストール
https://code.visualstudio.com/docs/copilot/chat/mcp-servers の手順に従ってください。 サーバーの起動に実行するコマンドは次のとおりです。
npx -y @fabrica.work/cli@latest server <utbid>>
注:ワークスペースではなくグローバルサーバーとしてインストールした場合、設定は次の場所にあります。
~/Library/Application Support/Code/User/settings.json
TODO
開発
ローカルソースから実行する
コンパイル:
pnpm run build
サーバーを実行するには:
npm exec fabrica server
インストールを実行するには:
npm exec fabrica cli install claude <utbid>
MCP inspector で実行するには、次のコマンドを使用します。
npx -y @modelcontextprotocol/inspector npx @fabrica.work/cli@latest server <utbid>
<utbid> を、用途に応じた識別子に置き換えてください。
環境変数
FABRICA_GATEWAY_URL
開発中にローカルのゲートウェイサーバーを使用する場合は、http://localhost:3000/api/mcp のような値を設定します。
npm パッケージの公開
package.json のバージョンをインクリメントします
pnpm publish
トラブルシューティング
ログ
トラブルシューティングのため、次の場所にあるログを確認してください。
- Claude:
/Users/<username>/Library/Logs/Claude
- Cursor TBD
- Windsurf TBD
全般
https://modelcontextprotocol.io/docs/tools/debugging を参照してください。
コントリビュート
このプロジェクトに貢献する場合は、次の手順に従ってください。
- リポジトリをフォークします。
- 機能追加またはバグ修正用の新しいブランチを作成します。
- 変更をコミットし、フォークにプッシュします。
- レビューを依頼するプルリクエストを送信します。
ライセンス
このプロジェクトは MIT License の下でライセンスされています。
追加リソース
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。