mcp-hello-world

What This Skill Does

The mcp-hello-world skill is an essential foundational tool designed for the OpenClaw AI agent ecosystem. It serves as a minimal, production-ready implementation of the Model Context Protocol (MCP). By installing this skill, users gain the ability to execute two primary operations: a mathematical addition tool ('add') and a personalized greeting service ('hello_world'). Beyond its simple utility, this skill acts as a bridge for developers who want to understand how MCP servers interact with AI agents. It encapsulates the core logic of request-response cycles, parameter validation, and tool registration, providing a robust boilerplate that can be easily extended into more complex functionalities like weather tracking, database querying, or web scraping.

Installation

To integrate this skill into your OpenClaw environment, ensure you have Node.js 22+ installed. You can install it globally via the terminal command: clawhub install openclaw/skills/skills/crystaria/mcp-hello-world. Once installed, navigate to the directory and run npm install to resolve all dependencies. The server runs over standard I/O, meaning it requires no complex network configurations, making it extremely secure and lightweight for local agent workflows.

Use Cases

This skill is highly versatile. Developers can use it as a scaffold to bootstrap their own custom tools by modifying the 'server.js' file with custom logic. It is perfect for educational settings, acting as a sandbox for students to learn how AI agents call external tools. Additionally, it serves as a testing utility to verify that your OpenClaw environment is correctly configured to communicate with MCP servers, ensuring that your agent's tool-calling pipeline is healthy and responsive.

Example Prompts

1. "OpenClaw, please use the mcp-hello-world tool to calculate the sum of 145 and 278."
2. "Use the greeting tool from the mcp-hello-world skill and say hello to the project lead."
3. "I need to test my tool pipeline; run the addition function with inputs 50 and 50 and tell me the result."

Tips & Limitations

To get the most out of this, ensure your parameters strictly follow the JSON Schema provided in the source code; the 'add' tool requires both 'a' and 'b' as numerical types. Be aware that this is a local-only skill; if you require cloud integration or cross-server communication, you will need to extend the server capabilities. Always verify your inputs before calling tools to prevent runtime errors, and refer to the project documentation in the 'src/server.js' file if you are planning to modify the internal tool logic.