mcpField
F
Fabrica MCP Stdio Bridge Server

Fabrica MCP Stdio Bridge Server

本地服务
github.com/franckc开发工具080 周前更新
代码仓库

关于 Fabrica MCP Stdio Bridge Server

Fabrica MCP Stdio Bridge Server 为使用本地 stdio 的客户端适配 Fabrica 网关的 HTTP Streamable 传输，包括 Claude Desktop、Cursor 和 Windsurf。它作为本地转接层，将请求转发至网关。

主要功能

  1. 01连接本地 stdio 与网关 HTTP
  2. 02将 MCP 请求转发到 Fabrica
  3. 03提供 Claude、Cursor、Windsurf 安装器
  4. 04提供 VS Code 启动命令

适用场景

  1. 01让仅支持 stdio 的客户端连接 Fabrica 网关
  2. 02为受支持的客户端添加 Fabrica 服务配置

MCP 相关

它作为本地 stdio MCP 服务运行，并通过 HTTP Streamable 传输将请求代理到 Fabrica 网关。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "fabrica-stdio": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Fabrica MCP Stdio Bridge Server

描述

这是一个桥接程序，供 Claude Desktop、Cursor 和 Windsurf 等客户端使用。这些客户端尚不支持 Fabrica 网关所使用的新 MCP HTTP Streamable 传输方式。它会在本地主机上启动一个使用 stdio 传输的 shim 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

待办

开发

从本地源码运行

编译：

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

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

参与贡献

如果你想为此项目做出贡献，请按照以下步骤操作：

  1. Fork 此仓库。
  2. 为你的功能或错误修复创建一个新分支。
  3. 提交更改并推送到你的 fork。
  4. 提交 pull request 以供审查。

许可证

本项目采用 MIT License 许可。

其他资源

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。