home / mcp / simple mcp server

Simple MCP Server

A basic stdio & streamable http implementation of FastMCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ilil1-simple-mcp-server": {
      "url": "http://localhost:9876/",
      "headers": {
        "SIMPLE_MCP_SERVER": "SIMPLE_MCP_SERVER"
      }
    }
  }
}

You can run a minimal MCP server that connects your AI workflows to simple tools and external data sources. It supports both HTTP and stdio transports, letting you connect from web clients or local runtimes, while providing a straightforward set of example tools you can extend.

How to use

To connect an MCP client, you can run the server in a mode that fits your setup and then point your client at the produced endpoint. The server exposes three run modes you can choose from, depending on whether you want HTTP, stdio, or both transports active.

Run with both transports (default)

python run_server.py

HTTP transport only

python run_server.py --http-only

stdio transport only

python run_server.py --stdio-only

Available tools

hello_world

A simple greeting tool that returns a friendly message. It accepts a name and an optional delay, and returns a greeting string.

get_version

Returns version information about the server, including its name and API version.

system_info

Provides basic system information such as Python version and platform details.