simple-mcp-server

TroteaTeodor/simple-mcp-server

3.2

If you are the rightful owner of simple-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a simple MCP server example designed to work with kagent.dev, featuring basic tools and proper protocol implementation.

Tools

  1. hello

    Say hello to someone

  2. echo

    Echo back a message

  3. get_time

    Get current time

  4. add_numbers

    Add two numbers

Simple MCP Server Example

A basic MCP (Model Context Protocol) server that works with kagent.dev.

Features

  • Simple HTTP server with SSE (Server-Sent Events) support
  • 4 basic tools: hello, echo, get_time, add_numbers
  • Proper MCP protocol implementation
  • Health checks and status endpoints
  • Docker support

Tools

  1. hello - Say hello to someone
  2. echo - Echo back a message
  3. get_time - Get current time
  4. add_numbers - Add two numbers

Quick Start

Local Development

npm install
npm start

Docker

docker build -t simple-mcp-example .
docker run -p 8000:8000 simple-mcp-example

Deploy to kagent

python deploy_mcp.py github.com/yourusername/simple-mcp-example

Endpoints

  • GET / - Server info
  • GET /health - Health check
  • GET /status - Server status with tools
  • GET /sse - SSE endpoint for kagent
  • POST /sse - Tool execution endpoint

Testing

Test the SSE endpoint:

curl -N http://localhost:8000/sse

Test a tool:

curl -X POST http://localhost:8000/sse \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/call","params":{"name":"hello","arguments":{"name":"World"}}}'