关于 streamable-mcp-server
streamable-mcp-server 是一个使用 TypeScript 编写的 MCP 服务起始模板,基于 Streamable HTTP 传输方式。适合希望以该模板为基础开发自有 MCP 服务的开发者,内置依赖与 tsconfig 配置。
主要功能
- 01基于 Streamable HTTP 传输的 MCP 服务
- 02包含会话管理示例
- 03TypeScript 与 tsconfig 配置
- 04支持 npm 构建与开发模式热重载
- 05可通过 PORT 环境变量指定端口
适用场景
- 01作为新建 Streamable HTTP MCP 服务的起点
- 02在本地运行并用支持远程服务的客户端连接测试
MCP 相关
该项目是一个 MCP 服务模板,通过 http://localhost:3000 等地址以 streamable-http 类型向 MCP 客户端提供服务。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
streamable-mcp-server
这是使用 TypeScript 构建新的 streamable-http MCP 服务的起点。
Streamable HTTP 传输于 2025-03-26 引入。查看 MCP 规范更新日志。
本项目基于 Model Context Protocol TypeScript SDK 的带会话管理的 Streamable HTTP 示例,并包含一些实用的依赖项和 tsconfig,助你快速上手。
克隆或派生此仓库,进行更新并开始构建你的 Streamable HTTP MCP 服务。
本地安装和运行
安装依赖项,请运行:
npm install
然后构建:
npm run build
运行服务
生产模式
要以生产模式运行服务:
npm start
# or directly with
node build/index.js
默认在端口 3000 上运行。如果需要使用其他端口,可以通过 PORT 环境变量指定。
PORT=3002 npm start
# or
PORT=3002 node build/index.js
开发模式
在开发过程中,可以使用开发模式。它会自动监视源文件的更改、重新构建并重启服务:
npm run dev
使用自定义端口:
PORT=3002 npm run dev
连接客户端
服务运行后,你可以将客户端连接到 Streamable HTTP MCP 服务。请根据客户端的配置进行设置。mcp-config.json 中提供了一个示例配置:
{
"mcpServers": {
"streamable-mcp-server": {
"type": "streamable-http",
"url": "http://localhost:3000"
}
}
}
后续改进:
- 处理 OAuth 身份验证
- 提供更多工具示例
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。