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

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

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
Advertise