Hello World

A TypeScript MCP server demonstrating resources, prompts, and tools accessible via HTTP/SSE or STDIO.

typescript

5

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

You are about to run a lightweight TypeScript MCP server that demonstrates core MCP capabilities, including static and dynamic resources, prompts, and a small toolset. It supports both HTTP/SSE transport for browser clients and STDIO for command-line integrations, making it easy to experiment and integrate into your workflows.

How to use

You connect to the MCP server using an MCP client over either HTTP/SSE or STDIO. In HTTP mode, your client browses and invokes resources and tools via the SSE endpoint and the messages endpoint. In STDIO mode, you interact directly through the command line, enabling scripting and automation without a browser.

How to install

Prerequisites: Node.js v16 or higher and npm or yarn.

npm install

npm run build

Additional content you can use with the MCP server

The server exposes a small set of resources, tools, and prompts you can explore with your MCP client.

Resources

- hello://world — A static hello world resource
- greeting://{name} — A dynamic greeting resource that accepts a name parameter

Tools

echo — Echoes back a message with a "Hello" prefix
debug — Lists all available tools and methods

Prompts

helpful-assistant — A basic helpful assistant prompt

Testing and running guidance

To run the HTTP/SSE server for browser clients, start the HTTP server and access the SSE endpoint at /sse and the messages endpoint at /messages.

npm run start:http

To run the STDIO server for command-line integrations, start the server in stdio mode.

npm run start

Troubleshooting

If you encounter common issues, ensure you are using the correct start command for your transport, verify the server prints the expected endpoints, and check the console for any debug information to trace session routing.

Notes

Session management is essential for routing messages between your MCP client and the server. Use the provided endpoints to experiment with resources and tools in a controlled session context.

License

MIT

Available tools

echo

Echoes back a message with a Hello prefix

debug

Lists all available tools and methods