Fiberflow MCP 网关使用说明

项目简介

Fiberflow MCP 网关是一个轻量级的工具，它充当 MCP 客户端和 MCP 服务器之间的桥梁。它主要解决 MCP 客户端（如 Claude 桌面应用）连接到远程 MCP 服务器的问题，支持通过标准输入输出 (Stdio) 或服务器发送事件 (SSE) 协议进行通信。该网关自身不提供资源、工具或 Prompt 模板的管理功能，而是作为一个代理，将客户端的请求转发到配置的后端 MCP 服务器。

主要功能点

MCP 协议桥接：实现了 MCP 协议的客户端和服务端传输层，能够理解和处理 MCP 消息。
Stdio 转 SSE：可以将基于 Stdio 的 MCP 客户端请求转换为 SSE 协议，连接到基于 SSE 的远程 MCP 服务器。
SSE 转 Stdio：反之，也可以将基于 SSE 的 MCP 客户端请求转换为 Stdio 协议，连接到本地或其他基于 Stdio 的 MCP 服务器（尽管仓库主要侧重于 Stdio 转 SSE）。
配置灵活：支持通过命令行参数配置端口、路径、日志级别和 CORS 等。
健康检查：提供健康检查端点，方便监控网关的运行状态。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。

安装 Fiberflow MCP 网关: 通过 npm 全局安装 'fiberflow-mcp-gateway'。

npm install -g fiberflow-mcp-gateway

服务器配置

MCP 客户端（例如 'claude_desktop_config.json'）需要配置以下信息以连接到 Fiberflow MCP 网关。以下配置示例展示了如何配置 Claude 桌面应用连接到通过 SSE 协议暴露的 Fiberflow MCP 网关。

{
  "mcpServers": {
    "fiberflow": {
      "command": "fiberflow-mcp-gateway",
      "args": [
        "--sse",
        "https://fiberflow.fiberflow.io/api/v1/sse/YOUR-FIBERFLOW-MCP-SERVER-SECRET"
      ]
    }
  }
}

配置参数说明:

'"fiberflow"': 服务器名称，可以自定义。
'"command": "fiberflow-mcp-gateway"': 启动 MCP 服务器的命令，这里直接使用全局安装的 'fiberflow-mcp-gateway' 命令。
'"args": [...]' : 传递给 'fiberflow-mcp-gateway' 命令的参数列表。
- '--sse': 指定以 SSE 客户端模式运行，并连接到指定的 SSE 服务器 URL。
- '"https://fiberflow.fiberflow.io/api/v1/sse/YOUR-FIBERFLOW-MCP-SERVER-SECRET"': [请替换为真实的 MCP 服务器 SSE 地址] 这是后端 Fiberflow MCP 服务器提供的 SSE 端点 URL，通常包含一个密钥用于身份验证。

其他配置 (可选):

如果你的后端 MCP 服务器是通过 Stdio 协议通信的，并且你想将网关作为 HTTP SSE 服务器暴露给 MCP 客户端，可以使用以下配置，并运行网关的 Stdio to SSE 模式：

Claude 客户端配置 (claude_desktop_config.json):

{
  "mcpServers": {
    "fiberflow-gateway": {
      "command": "fiberflow-mcp-gateway",
      "args": [
        "--stdio",
        "YOUR_STDIO_COMMAND",
        "--port",
        "8080"
      ]
    }
  }
}

配置参数说明:

'"fiberflow-gateway"': 自定义服务器名称。
'"command": "fiberflow-mcp-gateway"': 启动命令。
'"args": [...]' : 参数列表。
- '--stdio': 指定以 Stdio to SSE 模式运行。
- '"YOUR_STDIO_COMMAND"': [请替换为实际的 Stdio MCP 服务器启动命令] 这是你要桥接的后端 MCP 服务器的启动命令，例如 'node your-mcp-server.js'。
- '--port', '"8080"': 指定网关监听的端口，默认为 '8000'。MCP 客户端需要连接到 'http://localhost:8080/sse' (默认 SSE 路径)。

基本使用方法

配置 MCP 客户端: 根据你的后端 MCP 服务器类型 (SSE 或 Stdio) 和你的需求，选择合适的配置，并修改 MCP 客户端的配置文件（例如 'claude_desktop_config.json'）。
启动 Fiberflow MCP 网关: 如果使用 Stdio to SSE 模式，需要先启动 Fiberflow MCP 网关。如果 MCP 客户端配置中 'command' 和 'args' 正确，通常客户端会自动启动网关。如果手动启动，可以根据需要添加更多命令行参数，例如 '--port', '--logLevel', '--cors' 等。
启动 MCP 客户端: 启动你的 MCP 客户端应用程序 (例如 Claude 桌面应用)。客户端会根据配置连接到 Fiberflow MCP 网关，并通过网关与后端的 MCP 服务器进行通信。

常用命令行选项:

'--stdio <command>': 以 Stdio to SSE 模式运行，'<command>' 为后端 Stdio MCP 服务器的启动命令。
'--sse <url>': 以 SSE 客户端模式运行，连接到指定的 SSE 服务器 URL。
'--port <number>': 设置网关监听端口 (仅 Stdio to SSE 模式)，默认为 '8000'。
'--logLevel <level>': 设置日志级别，可选 'info' 或 'none'，默认为 'info'。
'--cors': 启用 CORS 支持，允许跨域请求。
'--healthEndpoint <path>': 添加健康检查端点，可以多次使用添加多个端点。

示例 (Stdio to SSE 模式):

假设你的后端 Stdio MCP 服务器启动命令是 'node my-stdio-server.js'，你想将网关运行在 8080 端口，可以这样配置客户端和启动网关 (客户端通常会自动启动):

客户端配置: (同上 'claude_desktop_config.json' 中 Stdio to SSE 示例)

无需手动启动网关，客户端会自动根据配置启动。 如果需要手动启动 (例如调试):

fiberflow-mcp-gateway --stdio "node my-stdio-server.js" --port 8080

示例 (SSE 客户端模式):

假设你的后端 SSE MCP 服务器地址是 'https://your-mcp-server.com/sse?secret=YOUR_SECRET'，你可以这样配置客户端:

客户端配置: (同上 'claude_desktop_config.json' 中 SSE 示例，替换 URL 为你的实际地址)

无需手动启动网关，客户端会自动根据配置启动。 如果需要手动启动 (例如调试，但通常不需要):

客户端配置已经包含了 'fiberflow-mcp-gateway' 的启动命令和参数，客户端会自动根据配置启动网关，用户通常无需手动运行 'fiberflow-mcp-gateway' 命令。

关键词