Fabrica Stdio

🚀 Fabrica MCP 標準輸入輸出橋接服務器

本項目是一個客戶端橋樑，可解決諸如 Claude Desktop、Cursor 和 Windsurf 等客戶端，暫不支持 Fabrica 網關新 MCP HTTP 流式傳輸協議的問題。它通過啟動一個 shim MCP 服務器，利用本地主機的標準輸入輸出（stdio）傳輸，並藉助 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

按照以下鏈接中的說明操作：VSCode MCP 服務器配置說明
要運行服務器的命令是：

npx -y @fabrica.work/cli@latest server <utbid>

注意：如果作為全局服務器安裝（vs 工作區），設置位於

~/Library/Application Support/Code/User/settings.json

🔧 技術細節

從本地源運行

構建

pnpm run build

運行服務器

npm exec fabrica server

運行安裝程序

npm exec fabrica cli install claude <utbid>

在 MCP 檢查儀下運行

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：待定
• Windsurf：待定

通用

請參閱 MCP 調試文檔

🤝 貢獻

如果您希望為該項目做出貢獻，請按照以下步驟操作：

1. 叉本地倉庫。
2. 為主功能或錯誤修復創建新分支。
3. 提交您的更改並推送到您的叉庫。
4. 提交拉取請求以供審查。

📄 許可證

此項目根據 MIT License 發佈。

📚 額外資源

• Fabrica 文檔
• MCP 協議規範