Rocket Countdown MCP Server

基本能力

产品定位

Rocket Countdown MCP Server 是一个娱乐性质的倒计时服务器，主要用于演示和测试 MCP 协议的功能。

核心功能

• 启动一个从 10 到 1 的倒计时，最后显示 "BLAST OFF!"
• 提供 continueCountdown 工具来模拟火箭倒计时

适用场景

• MCP 协议的学习和测试
• 与 Claude Desktop 等 MCP 客户端集成
• 开发人员调试 MCP 服务器

工具列表

1. continueCountdown: 模拟火箭倒计时，逐步倒数数字
2. 输入: current_number (整数, 0-10)
3. 动作: 输出 current_number 到 stderr (如 "10..."), 等待 1 秒
4. 输出: 返回包含 next_number_to_count (current_number - 1) 和 is_final 布尔值的 JSON。如果 current_number 为 0，则输出 "BLAST OFF!" 到 stderr 并返回 "Countdown complete!"
5. 用法: 客户端(LLM)需要重复调用此工具，将前一次调用返回的 next_number_to_count 作为下一次调用的 current_number 传入

常见问题解答

1. JSON 解析错误: 由于控制台输出干扰了 MCP 消息
2. 解决方案: 使用 console.error() 代替 console.log() 输出用户信息
3. 端口已被占用: 运行 MCP Inspector 时可能出现
4. 解决方案: 查找并终止占用端口的进程
5. 工具未列出/"预处理输入: undefined"错误: 可能是由于模式预处理导致
6. 解决方案: 从模式定义中移除 z.preprocess 包装

使用教程

使用依赖

• Node.js (v16 或更高版本)

安装教程

1. 克隆仓库
2. 安装依赖:

npm install

1. 启动开发模式服务器:

npm start

1. 使用 MCP Inspector 测试(需要编译):

npm run inspect

调试方式

1. 手动构建 JavaScript 输出:

npm run build

1. 使用编译后的文件运行检查器:

npx @modelcontextprotocol/inspector node index.js

1. 检查器通常运行在 http://localhost:5173

许可证

该项目遵循 CC0-1.0 开源许可条款，请参阅 CC0-1.0 了解完整条款。