Rocket Countdown MCP Server

🚀 火箭倒计时

本项目是一个简单的MCP协议服务器，可实现火箭发射倒计时功能。用户通过配置连接该服务器，借助相关工具与之交互，轻松体验火箭发射倒计时的乐趣。

🚀 快速开始

此项目是基于MCP协议的简单服务器，主要用于实现火箭发射倒计时功能。用户可通过配置连接到此服务器，并使用相关工具进行交互。

✨ 主要特性

继续倒计时（continueCountdown）

• 输入：当前数字
• 输出：下一个数字或结束信息
• 功能：从给定的数字开始继续倒计时，直到达到0并输出"BLAST OFF!"

示例用法

在与服务器建立连接后：

1. 调用continueCountdown工具启动倒计时，初始值为10。
2. 服务器将输出每个递减的数字。
3. 当倒计时到达0时，服务器将输出"BLAST OFF!"。

📦 安装指南

1. 克隆此仓库到本地。
2. 在项目目录中运行以下命令安装依赖：

npm install

3. 安装完成后，可以使用以下命令启动服务器：

npm run dev

💻 使用示例

在Claude Desktop中的使用

1. 按照以下方法在Claude Desktop中设置服务器：
   • 使用上述方法之一配置好服务器后。
2. 启动一个新的Claude聊天。
3. 告诉Claude使用连接的MCP服务器启动从10开始的倒计时。例如：“使用Rocket Countdown服务器从10开始倒计时。”
4. Claude将识别请求并调用continueCountdown工具，传入current_number: 10。
5. 点击批准工具使用。
6. 服务器将在其日志中输出"10..."（可通过Claude Desktop设置->开发者->查看日志）并返回下一个数字9给Claude。
7. Claude将自动再次调用continueCountdown传入current_number: 9。
8. 继续批准每个步骤的提示。
9. 当倒计时到达0时，服务器将在其日志中输出"BLAST OFF!"，Claude将报告倒计时完成。

⚠️ 重要提示

此工具需要多次调用和批准。倒计时进度（例如“10...”、“9...”等）和最终的“BLAST OFF!”消息会显示在服务器的日志中，而不是直接在聊天窗口中显示。聊天窗口主要会显示Claude请求批准每个步骤的信息。

📚 详细文档

0_阅读本文件（llm_docs/0_llm_read_first.md）

简要概述：请务必先阅读本文件，以了解如何在项目中使用文档。

火箭倒计时MCP协议实现（llm_docs/1_rocket countdown mcp protocol implementation.md）

详细说明了如何在项目中实现火箭倒计时功能的MCP协议。

调试指南（llm_docs/3_debugging_mcp_servers.md）

全面的调试指南，帮助用户排查和解决可能出现的问题。

🔧 技术细节

项目结构

• index.ts：主服务器文件，实现倒计时功能。
• package.json：项目依赖和脚本配置。
• .gitignore：忽略文件列表。
• README.md：项目文档。
• llm_docs/：与大语言模型交互的文档。

📄 许可证

本项目采用MIT许可证。

📈 变更日志

2025年3月29日（v1.0.2）

• 文档清理：
  • 更新了llm_docs/0_llm_read_first.md和llm_docs/3_debugging_mcp_servers.md，以准确反映当前的单个continueCountdown工具。
  • 纠正了文件路径和测试命令在LLM文档中的描述。
  • 添加了对同步文档更新的详细说明。
  • 确保所有LLM文档符合LLM - to - LLM风格指南。
• 项目清理：
  • 移除了编译后的JS文件（index.js）。
  • 更新了项目结构，使其更加简洁明了。

2025年3月28日（v1.0.1）

• 初始版本发布：
  • 发布了项目的第一个稳定版本。

❓ 常见问题

1. 服务器启动失败：
   • 检查安装是否完成。
   • 确保所有依赖项已正确安装。
2. 倒计时不工作：
   • 检查日志输出。
   • 确保工具调用和批准流程正确进行。

🔗 相关仓库

• MCP协议
• 其他示例项目