1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@my-mcp what's the current weather in New York?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

my-mcp

my-mcp is a Model Context Protocol (MCP) server built with FastMCP featuring dynamic tool loading.

Features

Dynamic Tool Loading: Tools are automatically discovered and loaded from src/tools/
One Tool Per File: Each tool is a single file with a function matching the filename
FastMCP Integration: Leverages FastMCP for robust MCP protocol handling
Configuration Management: Tool-specific configuration via mcp.yaml
Fail-Fast: Server won't start if any tool fails to load
Auto-Generated Tests: Automatic test generation for tool validation

Project Structure

src/ ├── tools/ # Tool implementations (one file per tool) │ ├── echo.py # Example echo tool │ └── __init__.py # Auto-generated tool registry ├── core/ # Dynamic loading framework │ ├── server.py # Dynamic MCP server │ └── utils.py # Shared utilities └── main.py # Entry point mcp.yaml # Configuration file tests/ # Generated tests

Quick Start

Option 1: Local Development (with Python/uv)

Install Dependencies:
uv sync
Run the Server:
# Stdio mode (default MCP transport) uv run python src/main.py # HTTP mode with WebSocket MCP endpoint uv run python src/main.py --http # HTTP mode with custom host/port uv run python src/main.py --http --host 0.0.0.0 --port 8080
Using uv Scripts:
# Development mode (HTTP on port 3000) uv run dev # HTTP mode uv run dev-http # Stdio mode uv run start
Add New Tools:
# Create a new tool (no tool types needed!) arctl mcp add-tool weather # The tool file will be created at src/tools/weather.py # Edit it to implement your tool logic

Option 2: Docker-Only Development (no local Python/uv required)

Build Docker Image:
arctl mcp build --verbose
Run in Container:
docker run -i my-mcp:latest
Add New Tools:
# Create a new tool arctl mcp add-tool weather # Edit the tool file, then rebuild arctl mcp build

HTTP Transport Mode

The server supports running in HTTP mode for development and integration purposes.

Starting in HTTP Mode

# Command line flag python src/main.py --http # Environment variable MCP_TRANSPORT_MODE=http python src/main.py # Custom host and port python src/main.py --http --host localhost --port 8080

Creating Tools

Basic Tool Structure

Each tool is a Python file in src/tools/ containing a function decorated with @mcp.tool():

# src/tools/weather.py from core.server import mcp from core.utils import get_tool_config, get_env_var @mcp.tool() def weather(location: str) -> str: """Get weather information for a location.""" # Get tool configuration config = get_tool_config("weather") api_key = get_env_var(config.get("api_key_env", "WEATHER_API_KEY")) base_url = config.get("base_url", "https://api.openweathermap.org/data/2.5") # TODO: Implement weather API call return f"Weather for {location}: Sunny, 72°F"

Tool Examples

The generated tool template includes commented examples for common patterns:

# HTTP API calls # async with httpx.AsyncClient() as client: # response = await client.get(f"{base_url}/weather?q={location}&appid={api_key}") # return response.json() # Database operations # async with asyncpg.connect(connection_string) as conn: # result = await conn.fetchrow("SELECT * FROM weather WHERE location = $1", location) # return dict(result) # File processing # with open(file_path, 'r') as f: # content = f.read() # return {"content": content, "size": len(content)}

Configuration

Configure tools in mcp.yaml:

tools: weather: api_key_env: "WEATHER_API_KEY" base_url: "https://api.openweathermap.org/data/2.5" timeout: 30 database: connection_string_env: "DATABASE_URL" max_connections: 10

Testing

Run the generated tests to verify your tools load correctly:

uv run pytest tests/

Development

Adding Dependencies

Update pyproject.toml and run:

uv sync

Code Quality

uv run black . uv run ruff check . uv run mypy .

Deployment

Docker

# Build image (handles lockfile automatically) arctl mcp build # Run container docker run -i my-mcp:latest

my-mcp

my-mcp

Features

Project Structure

Quick Start

Option 1: Local Development (with Python/uv)

Option 2: Docker-Only Development (no local Python/uv required)

HTTP Transport Mode

Starting in HTTP Mode

Creating Tools

Basic Tool Structure

Tool Examples

Configuration

Testing

Development

Adding Dependencies

Code Quality

Deployment

Docker

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API