streamable-mcp-server

streamable-mcp-server

site icon
2025.04.21 1
TypeScript流式 HTTP 传输会话管理其它
mcp-streamable-http-typescript-server 是一个基于 TypeScript 构建的流式 HTTP MCP 服务器模板项目。它提供了一个起点,用于开发支持流式 HTTP 传输的 MCP 服务器,并包含了一些合理的依赖项和配置。该项目适用于需要构建流式 HTTP MCP 服务器的开发者,提供了基本的安装、构建和运行指南。
View on GitHub

Overview

基本能力

产品定位

mcp-streamable-http-typescript-server 是一个用于构建流式 HTTP MCP 服务器的模板项目,旨在为开发者提供一个快速启动的开发环境。

核心功能

  1. 流式 HTTP 传输支持:支持 MCP 协议中的流式 HTTP 传输功能。
  2. 会话管理:基于 Model Context Protocol Typescript SDK 的会话管理示例。
  3. 可配置端口:支持通过环境变量配置服务器运行的端口。
  4. 客户端连接:提供示例配置文件,方便客户端连接。

适用场景

  1. 开发流式 HTTP MCP 服务器:适用于需要构建支持流式 HTTP 传输的 MCP 服务器的开发者。
  2. 快速原型开发:提供模板项目,方便开发者快速启动和测试。
  3. 会话管理研究:适用于研究 MCP 协议中会话管理的开发者。

工具列表

  1. npm:用于安装依赖项和管理项目。
  2. TypeScript:用于编写和构建项目。
  3. Node.js:用于运行服务器。

常见问题解答

  1. Inspector 问题:Inspector 可能与流式 HTTP 服务器存在兼容性问题。详情参见 GitHub Issue

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 克隆或 fork 项目仓库。
  2. 安装依赖项: bash npm install
  3. 构建项目: bash npm run build
  4. 运行服务器: bash node build/index.js 默认端口为 3000,如需更改端口,可使用以下命令: bash PORT=3002 node build/index.js

调试方式

  1. 确保服务器已成功运行并监听指定端口。
  2. 使用客户端连接服务器,检查连接是否正常。
  3. 查看日志和错误信息,排查问题。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。