mcp-demo-streamable-http-bridge

mcp-demo-streamable-http-bridge

介绍

mcp-demo-streamable-http-bridge

mcp-demo-streamable-http-bridge

介绍

这是一个演示项目，用于展示如何将 stdio 协议转换为 streamable-http 协议的桥接服务器。

软件架构

该桥接服务器使用 JavaScript 编写，基于 Node.js 平台，通过 HTTP 协议与客户端进行交互。

安装教程

1. 确保已安装 Node.js 和 npm。
2. 克隆仓库到本地。
3. 进入项目目录并运行 npm install 安装依赖。

使用说明

把 stdio 协议转为 streamable-http 协议

此桥接服务器可以接收来自 stdio 的输入，并将其转换为 HTTP 请求，以便在 HTTP 协议下进行通信。

桥接服务器使用说明

启动桥接服务器

运行以下命令启动桥接服务器：

node bridge-streamable.js

HTTP API Token 认证（可选）

为了增加安全性，可以配置 HTTP API Token 认证。在服务器配置中设置 Token，并在客户端请求时提供相应的 Token。

Linux/Mac

在 Linux 或 Mac 系统上，可以直接使用上述命令启动服务器。

Windows

在 Windows 系统上，确保已安装 Node.js，并使用命令提示符运行启动命令。

使用示例（无认证）

启动服务器后，可以通过发送 HTTP 请求来与桥接服务器进行交互。具体请求格式和示例请参考项目文档或代码中的注释。

使用说明

把 stdio 协议转为 streamable-http 协议

node D:\github\mcp-streamable-http-bridge\bridge-streamable.js "cmd" "/c"  "npx" "-y"  "@gitee/mcp-gitee@latest" -token <GITEE_ACCESS_TOKEN>

桥接服务器使用说明

启动桥接服务器

node bridge-streamable.js node index-stdio.js

HTTP API Token 认证（可选）

可以通过设置环境变量BRIDGE_API_TOKEN来启用 HTTP API Token 认证：

# Linux/Mac
export BRIDGE_API_TOKEN="your-secret-token"
node bridge-streamable.js node index-stdio.js

# Windows
set BRIDGE_API_TOKEN=your-secret-token
node bridge-streamable.js node index-stdio.js

启用认证后，所有 HTTP 请求都需要在 Authorization 头中提供 Bearer Token：

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-secret-token" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "test-client",
        "version": "1.0.0"
      }
    }
  }'

使用示例（无认证）

启动后，可以通过 HTTP 请求访问 MCP 服务：

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "test-client",
        "version": "1.0.0"
      }
    }
  }'

Streamable-HTTP协议MCP服务器配置示例

以下是使用streamable-http协议的MCP服务器配置文件示例：

1. 基础streamable-http配置

创建 mcp-streamable-config.json：

{
  "mcpServers": {
    "streamable-gitee": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

2. 带认证的streamable-http配置

创建 mcp-streamable-auth.json：

{
  "mcpServers": {
    "streamable-secure": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

3. 使用桥接服务器的streamable-http配置

创建 mcp-bridge-streamable.json：

{
  "mcpServers": {
    "gitee-bridge": {
      
      "transport": "streamable-http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

4. 多服务streamable-http配置

创建 mcp-streamable-services.json：

{
  "mcpServers": {
    "gitee-streamable": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer gitee-token"
      }
    },
    "filesystem-streamable": {
      "url": "http://localhost:3001/mcp",
      "transport": "streamable-http"
    },
    "fetch-streamable": {
      "url": "http://localhost:3002/mcp",
      "transport": "streamable-http"
    }
  }
}

5. 客户端连接streamable-http配置示例

创建 client-streamable-config.json：

{
  "mcp": {
    "servers": {
      "streamable-server": {
        "transport": {
          "type": "streamable-http",
          "url": "http://localhost:3000/mcp",
          "headers": {
            "User-Agent": "mcp-client/1.0"
          }
        }
      }
    }
  }
}