Hello World MCP Server

A minimal Model Context Protocol (MCP) server written in TypeScript. This project demonstrates how to create MCP-compliant resources and tools for use with LLMs and MCP-enabled clients like Claude Desktop.

Features

• MCP Resources:
  Provides simple resources at hello://greeting, hello://info, and a resource list at hello://list.

• MCP Tool:
  A helloTool that echoes messages or returns a default greeting.

• Stdio Transport:
  Communicates via standard input/output, making it easy to integrate with MCP clients.

Related MCP server: MCP Framework

Getting Started

Prerequisites

• Node.js (v18+ recommended)

• npm (comes with Node.js)

Install Dependencies

Build the Project

Compile TypeScript source files to JavaScript in the dist/ directory:

Run the Server (Standalone)

This will start the MCP server via Node.js using the built output.

Run Tests

Integration tests are provided to verify the MCP server works end-to-end:

This runs the tests in src/integration.test.ts using Jest.

Using with Claude Desktop

You can configure Claude Desktop or any MCP client to use this server as a plugin/tool by specifying the command to launch the MCP server.

Example Configuration Snippet

Add the following to your Claude Desktop settings (replace the path with your actual project path):

• Replace /path/to/mcp-hello-world-ts/ with the full path to where you cloned this repo.

• Make sure you have built the project (npm run build) before starting Claude Desktop.

Project Structure

Customization

• To add new tools or resources, create new files in src/resources/ or src/tools/ and register them in src/index.ts.

• Modify helloResource.ts or helloTool.ts to change the greeting or add additional functionality.

License

MIT License

Author

• @snoopdave