Fast MCP Server

by kongo97

261 downloads
Not rated
GitHub

About

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

Details

Author
kongo97
Downloads
261
Categories
Other

- Exposes tools as MCP endpoints over SSE
- Containerized for quick deployment with Docker Compose
- Configurable port and bind address
- Includes example tools (weather alerts & forecast)
- Simple JSON‑RPC communication over SSE

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Fast MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, then build and start the Docker container: docker compose build followed by docker compose up -d. Configure an MCP‑compatible client to connect via SSE at http://localhost:8100/sse. Customize the port or host by setting MCP_PORT and MCP_HOST environment variables in docker-compose.yml.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "fast-mcp-server": {
        "command": "docker",
        "args": [
            "compose",
            "build"
        ]
    }
}
# Fast MCP Server A lightweight MCP (Model Context Protocol) Server implementation exposing custom tools via SSE for integration with AI clients. ## Table of Contents - [Overview](#overview) - [Features](#features) - [Prerequisites](#prerequisites) - [Getting Started](#getting-started) - [Build the Docker Image](#build-the-docker-image) - [Start the Container](#start-the-container) - [Usage](#usage) - [Connecting an MCP Client](#connecting-an-mcp-client) - [Available Endpoints](#available-endpoints) - [Configuration](#configuration) - [Development](#development) - [Troubleshooting](#troubleshooting) - [License](#license) ## Overview 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.29 ## Getting Started Clone the repository and navigate into the project directory: ```bash git clone git@github.com:kongo97/fast-mcp-server.git cd fast-mcp-server ``` ### Build the Docker Image ```bash docker compose build ``` This will build the MCP Server image using the provided `Dockerfile`. ### Start the Container ```bash 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: ```bash 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 ``` Inside docs folder, you can find a simple configuration compatible with Claude Desktop (claude_desktop_config.json) ### 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: ```yaml 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: ```bash docker compose build docker compose up -d ``` 3. Check logs for errors: ```bash 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: ```bash docker ps docker logs simple-mcp-server ``` - **Client errors**: Check the client configuration for correct SSE URL and protocol version.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.