Simple MCP Server
About
A lightweight MCP (Model Context Protocol) Server implementation exposing custom tools via SSE for integration with AI clients.
Details
- Author
- kongo97
- Downloads
- 171
- Categories
- Other
Jump to
- 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)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Simple MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"simple mcp server": {
"simple-mcp-server-kongo97": {
"command": "docker",
"args": [
"compose",
"build"
]
}
}
}
}McpServers
{
"simple-mcp-server-kongo97": {
"command": "docker",
"args": [
"compose",
"build"
]
}
}Simple MCP Server
A lightweight MCP (Model Context Protocol) Server implementation exposing custom tools via SSE for integration with AI clients.
Table of Contents
- Overview - Features - Prerequisites - Getting Started - Build the Docker Image - Start the Container - Usage - Connecting an MCP Client - Available Endpoints - Configuration - Development - Troubleshooting - LicenseOverview
This repository provides a simple MCP Server that implements custom tools (e.g., weather lookups) and exposes them over Server-Sent Events (SSE). It can be run in a Docker container for quick deployment and integrates seamlessly with clients that support the MCP protocol.
Features
- Exposes tools as MCP endpoints over SSE - Containerized for easy deployment via Docker Compose - Configurable port and host - Example tools included (e.g., weather alerts & forecast)Prerequisites
- Docker ≥ 20.10 - Docker Compose ≥ 1.29Getting Started
Clone the repository and navigate into the project directory:
git clone git@github.com:kongo97/simple-mcp-server.git
cd simple-mcp-server
Build the Docker Image
docker compose build
This will build the MCP Server image using the provided Dockerfile.
Start the Container
docker compose up -d
This command will:
- Pull/build the image
- Start the container in detached mode
- Map port 8100 on the host to port 8100 in the container
To stop and remove the container, run:
docker compose down
Usage
Connecting an MCP Client
Configure your MCP-compatible client (e.g., Claude Desktop) to connect via SSE at:
http://localhost:8100/sse
Available Endpoints
| Method | Path | Description |
|--------|---------|----------------------------------------|
| GET | /sse | Open SSE stream for MCP communication |
| POST | /sse | Send JSON-RPC requests over SSE |
Configuration
You can customize the server port and host by setting environment variables in docker-compose.yml or directly in the container:
services:
mcp-server:
environment:
- MCP_PORT=8100 # default port
- MCP_HOST=0.0.0.0 # bind address
Development
1. Edit or add your MCP tools in src/server.py (or your chosen file).
2. Rebuild and restart the container:
docker compose build
docker compose up -d
3. Check logs for errors:
docker compose logs -f
Troubleshooting
- 404 on /sse: Ensure the server is bound to the correct port and path.
- Connection refused: Verify Docker is running and the container is healthy:
docker ps
docker logs simple-mcp-server
- Client errors: Check the client configuration for correct SSE URL and protocol version.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
