MCP Examples Project

This project demonstrates a Model Context Protocol (MCP) server and client setup, including tools and configuration for running the server in a Docker container.

Project Structure

.
├── Dockerfile                # Docker build instructions for the MCP server
├── pyproject.toml            # Python project configuration
├── uv.lock                   # Lock file for dependencies
├── README.md                 # Project documentation
├── client/                   # Client-side code (if any)
└── servers/                  # MCP server implementation
    ├── __init__.py
    ├── main.py               # Main entry point for the server
    └── tools/                # Additional server tools
        ├── __init__.py
        ├── calendar.py       # Calendar tool implementation
        ├── task_manager.py   # Task manager tool implementation
        └── weather.py        # Weather tool implementation

Setting Up and Building the Docker Image

Build the Docker ImageFrom the project root, run:
docker build -t mcp-example-stdio-server:latest .
This will create a Docker image named mcp-example-stdio-server:latest containing the MCP server.
Run the Server (Standalone)You can run the server directly with:
docker run --rm -i mcp-example-stdio-server:latest
The server will start and listen for MCP stdio requests.

`mcp.json` Configuration

The .vscode/mcp.json file configures how the MCP server is launched in development environments (such as VS Code):

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

type: stdio indicates the server communicates over standard input/output.
command: The command to launch the server (docker).
args: Arguments to run the Docker container with the built image.

This setup allows development tools to start the MCP server in a containerized environment automatically.

Additional Notes

Ensure Docker is installed and running on your system.
Update the Docker image as needed after making changes to the server code by rebuilding the image.
The servers/tools/ directory contains modular tool implementations that can be extended as needed.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A demonstration project that implements a Model Context Protocol (MCP) server with example tools for calendar, task management, and weather functionality in a Docker container.

Related MCP Servers

docker-mcp
QuantGeekDev
A
security
A
license
A
quality
A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.
Last updated -
4
354
Python
MIT License
Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
22
8
TypeScript
MIT License
Docker Explorer
jar285
-
security
A
license
-
quality
A Model Context Protocol server that provides tools for interacting with Docker images, containers, and registries, enabling AI assistants to search, analyze, and manage Docker resources through a standardized interface.
Last updated -
Python
MIT License
Docker Build MCP Server
ekdh600
-
security
F
license
-
quality
A TypeScript server that fully implements the Model Context Protocol (MCP) standard, providing API access to Docker CLI operations like build, run, stop, and image management through compatible AI clients.
Last updated -
TypeScript

View all related MCP servers

MCP Examples Project