mcp-wait: Model Context Protocol (MCP) Server

mcp-wait is a reference Model Context Protocol (MCP) server that demonstrates a simple note storage system and a wait utility, built using the create-python-server SDK.

Features

• Tools:
  • wait: Wait for a specified number of seconds before responding
    • Argument: seconds (integer)

Quickstart

Prerequisites

• uv (for dependency management)
• Python 3.8+

Installation

1. Install dependencies:

   uv sync

2. Run the server:

   uv --directory . run wait

Claude Desktop Integration

Add the following to your Claude Desktop config:

Development/Unpublished:

"mcpServers": {
  "wait": {
    "command": "uv",
    "args": ["--directory", "C:/cnext/mcp-wait", "run", "wait"]
  }
}

Published:

"mcpServers": {
  "wait": {
    "command": "uvx",
    "args": ["wait"]
  }
}

Development

Build & Publish

1. Sync dependencies:

   uv sync

2. Build distributions:

   uv build

3. Publish to PyPI:

   uv publish

   • Set credentials via --token/UV_PUBLISH_TOKEN or --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

For best results, use the MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory C:/cnext/mcp-wait run wait

Open the displayed URL in your browser to debug.

Containerization

Build and run with Docker:

docker build -t mcp-wait .
docker run --rm -p 8000:8000 mcp-wait

Project Structure

• src/wait/ — Main server implementation
• Dockerfile — Containerization
• pyproject.toml — Project metadata and dependencies
• uv.lock — Dependency lockfile