MCP SSE流式传输服务器

一个概念验证服务器,用于将模型上下文协议(MCP)通过STDIO传输转换为即时服务器发送事件(SSE)流,可作为服务部署。

  • by cameronking4
  • JavaScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 cameronking4/spawn-mcp

使用说明

MCP SSE服务器POC

一个概念验证服务器,用于将模型上下文协议(MCP)的STDIO传输到即时服务器发送事件(SSE)流中,可作为服务部署。即时远程托管MCP服务器,无需基础设施工作。

特性

  • 通过简单的UI创建和管理MCP服务器配置
  • 为每种配置生成稳定的SSE端点
  • 通过SSE流式传输实时模型响应
  • 使用Express、Drizzle ORM和PostgreSQL构建
  • 在Render上单击部署

地方发展

先决条件

  • Node.js(v18或更高版本)
  • PostgreSQL数据库

设置

  1. 克隆此存储库:
git clone https://github.com/yourusername/mcp-sse-poc.git
cd mcp-sse-poc
  1. 安装依赖项:
npm install
  1. 设置本地PostgreSQL数据库并创建 .env 包含数据库连接字符串的文件:
DATABASE_URL=postgresql://username:password@localhost:5432/mcp_sse_db
  1. 生成并运行迁移:
npm run generate
npm run migrate
  1. 启动开发服务器:
npm run dev
  1. 打开浏览器并导航到 http://localhost:3000

渲染部署

1.将你的代码推送到GitHub/GitLab

确保您的存储库包含此项目中的所有文件。

2.在Render上创建Web服务

  1. 登录到您的 渲染仪表板
  2. 点击 New → Web服务
  3. 连接您的GitHub/GitLab存储库
  4. 配置服务:
    • 名字:选择一个名称(例如。, mcp-sse-poc)
    • 环境:节点
    • 生成命令: npm install (这将触发构建和迁移的安装后脚本)
    • 启动命令: npm start
  5. 点击 创建Web服务

3.添加PostgreSQL数据库

  1. 在“渲染”中,单击 New → PostgreSQL数据库
  2. 命名它(例如。, mcp-sse-db)
  3. 选择免费计划
  4. 点击 创建数据库
  5. 复制提供的 DATABASE_URL 连接字符串

4.配置环境变量

  1. 返回您的Web服务
  2. 导航到 环境 标签
  3. 添加以下环境变量:
    • 钥匙: DATABASE_URL
    • 价值:粘贴您复制的连接字符串

5.部署

Render将自动部署您的应用程序。部署后,您可以通过Render提供的URL访问它。

用法

  1. 在浏览器中打开已部署的应用程序
  2. 通过输入名称和JSON配置创建新的MCP服务器配置
  3. 保存配置以生成SSE URL
  4. 在客户端应用程序中使用SSE URL来流式传输模型响应

配置示例

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

模型上下文协议(MCP)

模型上下文协议是一种轻量级的、基于STDIO的规范,用于通过标准输入/输出接口与语言模型进行交互。它允许实时流式传输模型响应,设计简单且可扩展。

核心概念

  1. STDIO传输

    • 输入:描述上下文消息的JSON blob
    • 输出:增量响应令牌流式传输到stdout
    • 错误和事件:stderr上的非阻塞通知
  2. JSON消息格式

    {
      "context": [
        { "role": "system", "content": "You are a helpful assistant." },
        { "role": "user", "content": "Translate to French: Hello, world!" }
      ],
      "stream": true
    }
    
  3. 服务器发送事件(SSE)

    • 每个JSON块都成为一个SSE事件
    • 与MCP单向流模型的完美映射

许可证

麻省理工学院