Advertise
MCP.so
Sign In

Simple MCP Server

@kongo97

Repository

Basic information

Category

Other

Transports

stdio

Author

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

Simple MCP Server config

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

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

Simple MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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`.

3

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.

4

What endpoints does the server expose?

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

5

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.

Comments

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
Advertise