AI导哈

随机名称生成服务

一个基于MCP协议的随机名称生成服务器，提供从预定义列表中返回随机名称的功能，支持Streamable HTTP传输协议。

  • by ganthonyGI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ganthonygi/mcp-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 -环境模式

许可证

麻省理工学院

相关 MCP