Random Name Server

MCP随机名称服务器

一种模型上下文协议（MCP）服务器，使用 可流式HTTP传输.

特性

• get_random_name：从预定义的5个名称列表中返回一个随机名称
• 使用TypeScript和MCP SDK（v1.13.2）构建
• 使用现代流式HTTP传输（不是传统的stdio）
• 使用node alpine使用Docker进行容器化
• 带会话管理的Express.js HTTP服务器

安装

npm install
npm run build

用法

地方发展

npm run dev

生产

npm start

默认情况下，服务器将在端口3000上启动（可通过以下方式配置 PORT 环境变量）。

码头工人

docker build -t mcp-random-name-server .
docker run -p 3000:3000 mcp-random-name-server

API终点

• POST /mcp -客户端通信的主MCP端点
• GET /mcp -服务器发送通知事件（带会话ID）
• DELETE /mcp -会话终止（带会话ID）
• GET /health -健康检查端点
• GET / -服务器信息

API文档

完整的OpenAPI 3.0规范可在 openapi.yaml，其中包括：

• 详细的端点文档
• 请求/响应模式
• MCP协议的JSON-RPC示例
• 会话管理详细信息
• 错误响应格式

可用工具

get_random_name

从预定义列表中返回一个随机名称：Alice、Bob、Charlie、Diana、Edward。

输入： 无需

输出： 随机名称作为文本

MCP传输

此服务器使用 可流式HTTP传输 它支持：

• 使用UUID的会话管理
• 服务器发送事件以获取实时通知
• 用于客户端到服务器通信的HTTP POST
• 正确遵守MCP协议

客户端连接

客户端应连接到 /mcp 使用Streamable HTTP传输协议的端点。服务器处理会话初始化，维护状态，并支持请求/响应和流式传输场景。

发展

• npm run build -编译TypeScript
• npm run watch -观看模式编译
• npm run dev -使用ts节点运行以进行开发

需求

• Node.js 18+
• TypeScript
• MCP SDK 1.13.2
• Express.js

环境变量

• PORT -服务器端口（默认值：3000）
• NODE_ENV -环境模式

许可证

麻省理工学院