py-mcp-Server-Vorlage

Dieses Repository dient als Vorlage für die Erstellung eigener MCP-Server (Model Context Protocol) in Python. Forken Sie dieses Repository, um loszulegen.

Setup mit UV

Dieses Projekt verwendet uv für die Python-Paketierung und die Verwaltung virtueller Umgebungen. Wenn Sie uv nicht installiert haben, lesen Sie bitte die offizielle UV-Installationsanleitung .

1. Klonen Sie Ihr gegabeltes Repository:

   git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY_NAME.git
   cd YOUR_REPOSITORY_NAME

2. Erstellen und aktivieren Sie die virtuelle Umgebung: uv erstellt normalerweise ein .venv -Verzeichnis im Stammverzeichnis Ihres Projekts.

   uv venv
   source .venv/bin/activate  # On macOS/Linux
   # .venv\Scripts\activate   # On Windows

3. Abhängigkeiten installieren: Dieses Projekt verwendet pyproject.toml zur Verwaltung von Abhängigkeiten.

   uv pip install .

   Wenn Sie neue Abhängigkeiten hinzufügen, definieren Sie diese in Ihrer Datei pyproject.toml und führen Sie diesen Befehl erneut aus. Wenn Sie aus irgendeinem Grund eine Datei requirements.txt verwenden, können Sie diese mit uv pip install -r requirements.txt installieren.

Related MCP server: mcp-framework-starter

Ausführen des Servers

Das Skript mcp_server.py startet den MCP-Server.

So führen Sie den Server direkt aus:

uv run python mcp_server.py

Integration mit Claude Desktop oder Cursor

Um diesen MCP-Server mit einer Anwendung wie Claude Desktop oder Cursor zu verwenden, müssen Sie ihn in den Anwendungseinstellungen konfigurieren. Die Konfiguration umfasst in der Regel die Angabe des Befehls zum Ausführen Ihres Servers.

Hier ist ein Beispiel für eine Konfiguration. Sie müssen /ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME durch den tatsächlichen absoluten Pfad zu Ihrem Projektverzeichnis auf Ihrem System ersetzen.

{
    "mcpServers": {
        "my-custom-python-server": {
            "command": "uv",
            "args": [
                "run",
                "--python",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/.venv/bin/python",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/mcp_server.py"
            ],
            "workingDirectory": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME"
        }
    }
}

Erklärung der Konfiguration:

• "my-custom-python-server" : Dies ist ein Name, den Sie Ihrer Serverkonfiguration geben.

• "command": "uv" : Gibt uv als auszuführenden Befehl an.

• "args" : Eine Liste von Argumenten für den uv Befehl:

  • "run" : Weist uv an, einen Befehl innerhalb seiner verwalteten Umgebung auszuführen.

  • "--python" : Gibt den zu verwendenden Python-Interpreter an. Es ist wichtig, dass Sie hier auf den Python-Interpreter in Ihrer virtuellen uv Umgebung ( .venv/bin/python ) verweisen.

  • "/ABSOLUTE/PATH/TO/PARENT/FOLDER/YOUR_REPOSITORY_NAME/mcp_server.py" : Der absolute Pfad zu Ihrem Serverskript.

• "workingDirectory" : Gibt das Arbeitsverzeichnis für den Serverprozess an, das das Stammverzeichnis Ihres Projekts sein sollte.

Wichtig:

• Stellen Sie sicher, dass die Pfade in den args und workingDirectory für Ihr System korrekt sind.

• Wenn die Anwendung uv nicht finden kann, müssen Sie möglicherweise den vollständigen Pfad im Feld "command" angeben. Sie finden diesen Pfad normalerweise, indem Sie unter macOS oder Linux which uv oder unter Windows where uv in Ihrem Terminal ausführen.

• Der Server hört standardmäßig auf stdio , wie in mcp_server.py ( mcp.run(transport='stdio') ) konfiguriert, was normalerweise auch von Anwendungen wie Cursor erwartet wird.

Nach der Konfiguration sollte die Anwendung mit Ihrem Python MCP-Server kommunizieren können.