跳到主要内容

@cloudbase/mcp-transformer

云开发 MCP 协议转换工具,支持多种传输协议转换模式。

安装到全局:

npm i -g @cloudbase/mcp-transformer

命令列表

streamableToStdio - Streamable HTTP 转 STDIO

USAGE
npx @cloudbase/mcp-transformer streamableToStdio (--url value) [--token value] [--header value]...

FLAGS
--url POST 服务器 URL [必填]
[--token] 认证令牌,自动添加到 Authorization 请求头
[--header]... 自定义请求头(格式:"Header: Value"
-h --help 显示帮助信息

示例:
npx @cloudbase/mcp-transformer streamableToStdio --url https://api.example.com/messages \
--token "Bearer xyz" \
--header "X-Request-ID: 123"

postToStdio - POST 转 STDIO

USAGE
npx @cloudbase/mcp-transformer postToStdio (--url value) [--token value] [--header value]...

FLAGS
--url POST 服务器 URL [必填]
[--token] 认证令牌,自动添加到 Authorization 请求头
[--header]... 自定义请求头(格式:"Header: Value"
-h --help 显示帮助信息

示例:
npx @cloudbase/mcp-transformer postToStdio --url https://api.example.com/messages \
--token "Bearer xyz" \
--header "X-Request-ID: 123"

sseToStdio - SSE 转 STDIO

USAGE
npx @cloudbase/mcp-transformer sseToStdio (--url value) [--token value] [--header value]...

FLAGS
--url SSE 服务器 URL [必填]
[--token] 认证令牌
[--header]... 自定义请求头
-h --help 显示帮助信息

示例:
npx @cloudbase/mcp-transformer sseToStdio --url https://sse.example.com/events \
--header "Cache-Control: no-cache"

stdioToStreamable - STDIO 转 Streamable HTTP

USAGE
npx @cloudbase/mcp-transformer stdioToStreamable (--stdioCmd value) [--verifyAccess] [--port value] [--enableCors] [--stateful] [--sessionTimeout value] [--streamableHTTPPath value]

FLAGS
--stdioCmd STDIO 服务启动命令 [必填]
[--verifyAccess/--noVerifyAccess] 验证访问令牌 [default = true]
[--port] 服务端口 [default = 3000]
[--enableCors] 启用 CORS [default = false]
[--stateful] 启用有状态会话 [default = false]
[--sessionTimeout] 会话超时时间(毫秒)。仅支持有状态模式,如不设置则仅在客户端明确终止时删除会话
[--streamableHTTPPath] Streamable HTTP 端点路径 [default = /messages]
-h --help 显示帮助信息

示例:
npx @cloudbase/mcp-transformer stdioToStreamable \
--stdioCmd "node server.js" \
--port 8080 \
--enableCors \
--stateful \
--sessionTimeout 300000

stdioToCloudrunSse - STDIO 转云托管 SSE

USAGE
npx @cloudbase/mcp-transformer stdioToCloudrunSse (--stdioCmd value) [--verifyAccess] [--port value] [--ssePath value] [--enableCors]

FLAGS
--stdioCmd STDIO 服务启动命令 [必填]
[--verifyAccess] 验证访问令牌 [default = true]
[--port] 服务端口 [default = 3000]
[--ssePath] SSE 端点路径 [default = /messages]
[--enableCors] 启用 CORS [default = false]
-h --help 显示帮助信息

示例:
npx @cloudbase/mcp-transformer stdioToCloudrunSse \
--stdioCmd "python server.py" \
--port 8080 \
--enableCors

stdioToCloudrun - STDIO 转云托管 POST + SSE

USAGE
npx @cloudbase/mcp-transformer stdioToCloudrun (--stdioCmd value) [--verifyAccess] [--port value] [--enableCors] [--sseRoute local]

FLAGS
--stdioCmd STDIO 服务启动命令 [必填]
[--verifyAccess] 验证访问令牌 [default = true]
[--port] 服务端口 [default = 3000]
[--enableCors] 启用 CORS [default = false]
[--sseRoute] SSE 路由设置(本地开发使用 'local'
-h --help 显示帮助信息

示例(本地开发):
npx @cloudbase/mcp-transformer stdioToCloudrun \
--stdioCmd "node ./server.js" \
--sseRoute local \
--noVerifyAccess