Simple MCP Server

Name: Simple MCP Server
Author: kongo97

@kongo97

About Simple MCP Server

A lightweight MCP (Model Context Protocol) Server implementation exposing custom tools via SSE for integration with AI clients.

#mcp #server #ai-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "simple-mcp-server-kongo97": {
      "command": "docker",
      "args": [
        "compose",
        "build"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Simple MCP Server?

A lightweight MCP (Model Context Protocol) Server implementation that exposes custom tools (e.g., weather lookups) over Server-Sent Events (SSE) for integration with AI clients.

How to use Simple MCP Server?

Build the Docker image using docker compose build, then start the container with docker compose up -d. Connect any MCP-compatible client (e.g., Claude Desktop) to http://localhost:8100/sse. Customize port and host via MCP_PORT and MCP_HOST environment variables. To develop custom tools, edit src/server.py and rebuild.

Key features of Simple MCP Server

Exposes tools as MCP endpoints over SSE
Containerized for easy deployment with Docker Compose
Configurable port and host via environment variables
Includes example tools (weather alerts & forecast)

Use cases of Simple MCP Server

Integrate custom tools into AI assistants via the MCP protocol
Quickly deploy a lightweight MCP server using Docker
Develop and test new MCP tools locally

FAQ from Simple MCP Server

What prerequisites are needed to run Simple MCP Server?

Docker version 20.10 or later and Docker Compose version 1.29 or later are required.

How do I connect an MCP client to the server?

Configure your MCP-compatible client (e.g., Claude Desktop) to connect via SSE at http://localhost:8100/sse.

How can I change the port or host the server binds to?

Set the environment variables MCP_PORT (default 8100) and MCP_HOST (default 0.0.0.0) in the Docker Compose file or in the container.

What endpoints does the server expose?

GET /sse opens an SSE stream for MCP communication; POST /sse sends JSON-RPC requests over SSE.

How do I troubleshoot connection issues?

Check that the container is running (docker ps), verify logs with docker compose logs -f, and ensure the client uses the correct SSE URL. If you get a 404, make sure the server is bound to the correct port and path.