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

按照以下链接中的说明操作：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 协议规范