Fabrica Stdio

🚀 Fabrica MCP 标准输入输出桥接服务器

本项目是一个客户端桥梁，为当前尚不支持 Fabrica 网关新 MCP HTTP 流式传输协议的客户端（如 Claude Desktop、Cursor 和 Windsurf）提供支持。它会启动一个 shim MCP 服务器，在本地主机上使用标准输入输出（stdio）传输，并通过 HTTP 将请求代理到 Fabrica 的网关。

🚀 快速开始

该桥接服务器主要用于适配不支持 Fabrica 网关新 MCP HTTP 流式传输协议的客户端，通过启动本地 shim MCP 服务器，实现请求的代理转发。

✨ 主要特性

• 为不支持新 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

请按照以下链接中的说明操作：https://code.visualstudio.com/docs/copilot/chat/mcp-servers
运行服务器的命令如下：

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

通用

请参考 https://modelcontextprotocol.io/docs/tools/debugging

贡献

若您希望为该项目做出贡献，请按以下步骤操作：

1. 叉本地仓库。
2. 为主功能或错误修复创建新分支。
3. 提交您的更改并推送到您的叉库。
4. 提交拉取请求以供审查。

📄 许可证

此项目根据 MIT License 发布。

额外资源

• Fabrica 文档
• MCP 协议规范