mcpField
S
streamable-mcp-server

streamable-mcp-server

本地服务
github.com/ferrants开发工具2178 周前更新

关于 streamable-mcp-server

streamable-mcp-server 是一个使用 TypeScript 编写的 MCP 服务起始模板,基于 Streamable HTTP 传输方式。适合希望以该模板为基础开发自有 MCP 服务的开发者,内置依赖与 tsconfig 配置。

主要功能

  1. 01基于 Streamable HTTP 传输的 MCP 服务
  2. 02包含会话管理示例
  3. 03TypeScript 与 tsconfig 配置
  4. 04支持 npm 构建与开发模式热重载
  5. 05可通过 PORT 环境变量指定端口

适用场景

  1. 01作为新建 Streamable HTTP MCP 服务的起点
  2. 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 身份验证
  • 提供更多工具示例

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。