HelloWorld MCP Server
A simple HelloWorld MCP (Model Context Protocol) server experiment built with TypeScript.
Features
This MCP server provides two simple tools:
- hello: Say hello to someone (default: "World")
- add: Add two numbers together
Prerequisites
- Node.js 22+ (LTS)
- npm
- nvm (recommended for Node.js version management)
- direnv (for environment management)
Setup
- Node.js Version Management
- Environment Setup with direnv
- Install Dependencies
Development
Available Scripts
npm run dev
- Run the server in development mode using tsxnpm run build
- Compile TypeScript to JavaScriptnpm start
- Run the compiled servernpm run lint
- Run ESLint on the source codenpm run lint:fix
- Run ESLint and automatically fix issuesnpm run clean
- Remove the dist directory
Running the Server
For development:
For production:
MCP Server Usage
This server communicates via stdio and implements the Model Context Protocol. It provides:
Tools
- hello
- Description: Say hello to someone
- Parameters:
name
(optional): The name of the person to greet (default: "World")
- Example:
{"name": "Alice"}
→ "Hello, Alice! 👋 Welcome to the HelloWorld MCP server!"
- add
- Description: Add two numbers together
- Parameters:
a
(required): First numberb
(required): Second number
- Example:
{"a": 5, "b": 3}
→ "5 + 3 = 8"
Project Structure
Code Quality
This project uses:
- TypeScript for type safety
- ESLint with TypeScript support for code quality
- Strict TypeScript configuration for better type checking
License
MIT
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A simple TypeScript MCP server that provides two tools: one for greeting users with a customizable name and another for adding two numbers together.
Related MCP Servers
- AsecurityAlicenseAqualityThis TypeScript-based MCP server enables users to manage a simple notes system with capabilities to create and summarize notes through structured prompts and resources.Last updated -50TypeScriptMIT License
- -securityFlicense-qualityThis TypeScript-based MCP server allows users to manage a simple notes system through creating and summarizing text notes using Model Context Protocol (MCP).Last updated -5447TypeScript
- AsecurityAlicenseAqualityA TypeScript-based server that allows calling other MCP clients from your own MCP client, facilitating task delegation and context window offloading for enhanced multi-agent interactions.Last updated -326JavaScriptMIT License
- AsecurityFlicenseAqualityA simple and extendable MCP server that currently provides basic addition functionality and can be easily extended by defining new tools with docstrings.Last updated -4Python