MCP协议转换适配器

该产品是一个MCP协议转换适配器,用于将支持STDIO的MCP客户端与可流式HTTP MCP服务器集成,使开发者能够立即使用可流式HTTP传输功能。

  • by pyroprompts
  • JavaScript
  • 本地部署
  • 26 星标
  • 更新于
在 GitHub 查看 pyroprompts/mcp-stdio-to-streamable-http-adapter

使用说明

mcp stdio到可流式传输的http适配器mcp服务器

将任何支持STDIO MCP服务器的MCP客户端(大多数都支持)与可流式HTTP MCP服务器集成

如果你有一个流式HTTP MCP服务器,分叉、硬编码URI和发布将为你提供一个可以指向、添加到目录并让人们通过STDIO使用的仓库。

备注:这与 mcp远程包

为什么?

这 MCP规范将于2025年3月底添加流式HTTP传输 截至4月底,没有客户接受支持。typescript-sdk已合并代码,但尚未发布。Python SDK仍在开发中以支持它。Inspector支持它,但仅此而已。

这让开发人员处于尴尬的境地。使用STDIO或SSE(已弃用)开发MCP服务器,使其与客户端配合使用,或使用Streamable HTTP传输进行开发,但没有人可以使用它。

一、铁酸盐)我想开始集成Streamable HTTP MCP服务器,而不仅仅是检查器,所以我需要一种方法立即将它们连接到客户端和LLM!

此包旨在通过作为一个STDIO MCP服务器来桥接上限,该服务器可以中继到您的流式HTTP MCP服务器。这使得所有MCP客户端立即支持Streamable HTTP。现在开发人员可以开发流式HTTP MCP服务器并提供安装方法。

安装

要将OpenAI添加到Claude Desktop,请添加服务器配置:

在MacOS上: ~/Library/Application Support/Claude/claude_desktop_config.json

在Windows上: %APPDATA%/Claude/claude_desktop_config.json

环境变量

  • URI:流式HTTP MCP服务器的URL。这是必需的。
  • MCP_NAME:MCP服务器的名称。这是可选的。如果您配置了多个,这是必需的,这样它们就不会有相同的名称。
  • BEARER_TOKEN:流式HTTP MCP服务器的承载令牌。这是可选的。如果指定,这将在Authorization标头中一起发送。

配置

您可以通过以下方式使用它 npx 在您的Claude Desktop配置中,如下所示:

{
  "mcpServers": {
    "my-saas-app-development": {
      "command": "npx",
      "args": [
        "@pyroprompts/mcp-stdio-to-streamable-http-adapter"
      ],
      "env": {
        "URI": "http://localhost:3002/mcp",
        "MCP_NAME": "local-custom-streamable-http-adapter"
      }
    }
  }
}

或者,如果你克隆了仓库,你可以像这样在Claude Desktop配置中构建和使用:


{
  "mcpServers": {
    "my-saas-app-development": {
      "command": "node",
      "args": [
        "/path/to/mcp-stdio-to-streamable-http-adapter/build/index.js"
      ],
      "env": {
        "URI": "http://localhost:3002/mcp",
        "MCP_NAME": "local-custom-streamable-http-adapter"
      }
    }
  }
}

您可以通过多次引用同一MCP服务器,但使用不同的env参数来添加多个提供程序:


{
  "mcpServers": {
    "my-saas-app-development": {
      "command": "node",
      "args": [
        "/path/to/mcp-stdio-to-streamable-http-adapter/build/index.js"
      ],
      "env": {
        "URI": "http://localhost:3002/mcp",
        "MCP_NAME": "local-custom-streamable-http-adapter"
      }
    },
    "pyroprompts": {
      "command": "node",
      "args": [
        "/path/to/mcp-stdio-to-streamable-http-adapter/build/index.js"
      ],
      "env": {
        "URI": "https://api.pyroprompts.com/mcp",
        "MCP_NAME": "pyroprompts",
        "BEARER_TOKEN": "abcdefg"
      }
    }
  }
}

有了这三个,您将在Claude Desktop主页中看到每个工具:

然后你可以和其他LLM聊天,它在聊天中显示如下:

或者,在中配置 Librechat 比如:

  my-saas-app-development:
    type: stdio
    command: npx
    args:
      - -y
      - @pyroprompts/mcp-stdio-to-streamable-http-adapter
    env:
      URI: "http://localhost:3002/mcp",
      MCP_NAME: "my-custom-saas-app"
      PATH: '/usr/local/bin:/usr/bin:/bin'

它在LibreChat中显示:

发展

安装依赖项:

npm install

构建服务器:

npm run build

对于自动重建的开发:

npm run watch

调试

由于MCP服务器通过stdio进行通信,调试可能具有挑战性。我们建议使用 MCP检查员,可作为包脚本使用:

npm run inspector

检查器将提供一个URL,用于访问浏览器中的调试工具。

致谢