Simple MCP Server

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.