lailo/mcp-example

Example MCP Server

An example of how to run a MPC server in Python.

Development Setup

Prerequisites

• Python 3.12 or higher
• UV package manager

Installation

1. Clone the repository:

git clone <repository-url>
cd mcp-example

2. Install dependencies:

# Install main dependencies
uv sync

# Install development dependencies (for linting, formatting, etc.)
uv sync --extra dev

Running the MCP Server

To run the MCP server with the testing UI, you can execute the following UV command:

uv run mcp dev main.py

Development Tools

This project uses several development tools for code quality. All tools are configured in pyproject.toml and can be run locally:

Code Formatting and Linting

Format code with Black:

uv run black .

Sort imports with isort:

uv run isort .

Lint code with flake8:

uv run flake8 .

Type checking with mypy:

uv run mypy .

Run All Checks

You can run all the same checks that the CI pipeline runs:

# Format and lint
uv run black --check .
uv run isort --check-only .
uv run flake8 .
uv run mypy .

Configuration

The following configuration is for the Claude desktop client.

{
  "mcpServers": {
    "mcp-example": {
      "command": "uv",
      "args": [
        "--directory",
        "___PATH_TO_THIS_REPOSITORY___",
        "run",
        "main.py"
      ]
    }
  }
}