home / mcp / mcp examples server

MCP Examples Server

Demonstrates an MCP server and client setup with Docker-based deployment and modular tools.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "c1r5-mcp-examples": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-example-stdio-server:latest"
      ]
    }
  }
}

You learn how to run an MCP server inside a container and connect an MCP client to perform actions via established tools. This setup is useful for experimentation, isolated testing, and integrating server-side capabilities like calendar, task management, and weather data into your applications.

How to use

You will run the MCP server inside a container and connect an MCP client that communicates over standard input/output. Once the server is running, you can invoke tools such as the calendar, task manager, and weather functions through your MCP client. The server handles requests, executes the corresponding tool logic, and returns results or updates to your client.

How to install

Prerequisites you need before starting:

Docker Desktop or Docker Engine installed and running
Git or access to a shell for commands

Step 1: Build the Docker image for the MCP server.

docker build -t mcp-example-stdio-server:latest .

Step 2: Run the MCP server container in stdio mode.

docker run --rm -i mcp-example-stdio-server:latest

Step 3: (Optional) If you want development tooling to launch the server for you, use the following configuration snippet to integrate with your editor or tooling environment.

{
  "servers": {
    "example_mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-example-stdio-server:latest"
      ]
    }
  },
  "inputs": []
}

Additional configuration and notes

The server ships with modular tools that can be extended. You can locate calendar, task manager, and weather tool implementations under the server tools package. The setup assumes you want to run the server locally in a container and connect via standard input/output.

Available tools

calendar

Calendar tool implementation that manages events and scheduling within the MCP context.

task_manager

Task manager tool that handles to-do items and task tracking through the MCP server.

weather

Weather tool that retrieves weather information and integrates it into MCP workflows.