Rocket Countdown MCP Server

🚀 Rocket Countdown

A simple MCP protocol server that implements the rocket launch countdown function.

🚀 Quick Start

This project is a simple server based on the MCP protocol, primarily designed to implement the rocket launch countdown function. Users can configure and connect to this server and interact with it using relevant tools.

✨ Features

Continue Countdown (continueCountdown)

• Input: Current number
• Output: The next number or an end message
• Function: Continue the countdown from the given number until it reaches 0 and output "BLAST OFF!"

Example Usage

After establishing a connection with the server:

1. Call the continueCountdown tool to start the countdown with an initial value of 10.
2. The server will output each decreasing number.
3. When the countdown reaches 0, the server will output "BLAST OFF!"

📚 Documentation

Usage in Claude Desktop

1. Set up the server in Claude Desktop as follows:
   • After configuring the server using one of the above methods.
2. Start a new Claude chat.
3. Tell Claude to start a countdown from 10 using the connected MCP server. For example: "Start a countdown from 10 using the Rocket Countdown server."
4. Claude will recognize the request and call the continueCountdown tool, passing in current_number: 10.
5. Click to approve the tool usage.
6. The server will output "10..." in its log (viewable via Claude Desktop Settings -> Developer -> View Logs) and return the next number, 9, to Claude.
7. Claude will automatically call continueCountdown again, passing in current_number: 9.
8. Continue to approve the prompts for each step.
9. When the countdown reaches 0, the server will output "BLAST OFF!" in its log, and Claude will report that the countdown is complete.

⚠️ Important Note

This tool requires multiple calls and approvals. The countdown progress (e.g., "10...", "9...") and the final "BLAST OFF!" message will be displayed in the server's log, not directly in the chat window. The chat window will mainly display Claude's requests for approval at each step.

🔧 Technical Details

Project Structure

• index.ts: The main server file that implements the countdown function.
• package.json: Project dependencies and script configurations.
• .gitignore: List of files to be ignored.
• README.md: Project documentation.
• llm_docs/: Documentation for interacting with large language models.

📦 Installation

1. Clone this repository to your local machine.
2. Run the following command in the project directory to install dependencies:

npm install

3. After the installation is complete, you can start the server using the following command:

npm run dev

Documentation Files

• 0_Reading This Document (llm_docs/0_llm_read_first.md):
  • Brief Overview: Be sure to read this document first to understand how to use the documentation in the project.
• Rocket Countdown MCP Protocol Implementation (llm_docs/1_rocket countdown mcp protocol implementation.md):
  • Details how to implement the MCP protocol for the rocket countdown function in the project.
• Debugging Guide (llm_docs/3_debugging_mcp_servers.md):
  • A comprehensive debugging guide to help users troubleshoot and solve potential issues.

💡 Frequently Asked Questions

1. Server fails to start:

• Check if the installation is complete.
• Ensure that all dependencies are correctly installed.

2. Countdown does not work:

• Check the log output.
• Ensure that the tool call and approval process is carried out correctly.

📄 Related Repositories

• MCP Protocol
• Other Example Projects

📄 License

MIT

📈 Change Log

March 29, 2025 (v1.0.2)

• Documentation Cleanup:
  • Updated llm_docs/0_llm_read_first.md and llm_docs/3_debugging_mcp_servers.md to accurately reflect the current single continueCountdown tool.
  • Corrected the descriptions of file paths and test commands in the LLM documentation.
  • Added detailed instructions for synchronous document updates.
  • Ensured that all LLM documentation complies with the LLM-to-LLM style guide.
• Project Cleanup:
  • Removed the compiled JS file (index.js).
  • Updated the project structure to make it more concise and clear.

March 28, 2025 (v1.0.1)

• Initial Stable Release:
  • Released the first stable version of the project.