MCP-Server

Ein erweiterbarer Model Context Protocol (MCP)-Server mit Wetter- und Zeit-Tools. Entwickelt zum Lernen – verbinden Sie ihn mit Claude Desktop und beginnen Sie zu chatten.

Erste Schritte

1. Klonen & Installieren

git clone <repo-url> && cd mcp-server
python3 -m venv .venv
source .venv/bin/activate   # macOS / Linux / WSL
pip install -e .

Oder mit uv:

git clone <repo-url> && cd mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .

2. Mit Claude Desktop verbinden

Führen Sie das Setup-Skript aus, um die Konfigurationsdatei von Claude Desktop automatisch zu schreiben:

macOS:

python setup_claude_agent.py

Dies schreibt ~/Library/Application Support/Claude/claude_desktop_config.json und verweist auf das .venv/bin/python Ihres Projekts.

Wenn sich Ihr Projekt an einem nicht standardmäßigen Speicherort befindet, geben Sie diesen explizit an:

python setup_claude_agent.py --project-path /path/to/mcp-server

Windows (via WSL):

python3 setup_claude_agent.py --windows --win-user <YourWindowsUser> --wsl-user <YourWSLUser>

Zum Beispiel:

python3 setup_claude_agent.py --windows --win-user Cam --wsl-user cam

Dies schreibt %APPDATA%\Claude\claude_desktop_config.json und konfiguriert Claude Desktop so, dass der Server über WSL gestartet wird.

3. Claude Desktop neu starten

Schließen Sie Claude Desktop und öffnen Sie es erneut. Um zu überprüfen, ob der Server verbunden ist, gehen Sie zu Einstellungen → Entwickler — Sie sollten mcp-server mit einem grünen running-Badge sehen.

4. Ausprobieren

Fragen Sie Claude eines der folgenden Dinge:

• "Wie spät ist es?" — verwendet das get_current_time-Tool

• "Hole Wetterwarnungen für Kalifornien" — verwendet die Ressource weather://alerts/CA

• "Wie ist die Vorhersage für Breitengrad 40.7128, Längengrad -74.0060?" — verwendet die Vorhersage-Ressource

Sie müssen den Server nicht manuell starten — Claude Desktop startet ihn automatisch.

Related MCP server: mcp-weather

Verfügbare Tools & Ressourcen

Eigene Tools hinzufügen

Öffnen Sie src/mcp_server/server.py und fügen Sie eine Funktion mit dem @mcp.tool()-Dekorator hinzu:

@mcp.tool()
async def my_tool(param: str) -> str:
    """Description of what this tool does."""
    return f"Result for {param}"

Starten Sie Claude Desktop neu, um die Änderung zu übernehmen.

Für Ressourcen und Prompts siehe CONTRIBUTING.md.

Tests ausführen

pip install -e ".[dev]"   # or: uv pip install -e ".[dev]"
pytest

Projektstruktur

src/mcp_server/
├── server.py              # MCP server entry point — register tools here
└── tools/
    ├── weather/           # Weather alerts & forecasts (NWS API)
    ├── time/              # IP-based timezone & current time
    └── conversation/      # Conversation tools

Lizenz

MIT

Ressourcen

• Model Context Protocol Docs

• National Weather Service API

• Einen MCP-Server erstellen