mcp-server-starter

Grundgerüst für den Aufbau eines Model Context Protocol (MCP) Servers in Python. Forken Sie dieses Repository, wenn Sie eine eigene Sammlung von Tools/Daten für Claude Desktop, Claude Code oder einen anderen MCP-kompatiblen Client bereitstellen möchten.

Was ist ein MCP-Server?

MCP ist ein offenes Protokoll, das es Sprachmodell-Clients ermöglicht, über eine Standardschnittstelle auf externe Tools und Datenquellen zuzugreifen. Ein MCP-Server ist der kleine Prozess, der diese Tools hostet – Sie schreiben die Funktionen, das Protokoll kümmert sich um die Erkennung und den Aufruf.

Schnellstart

Installieren Sie es direkt aus diesem Repository mit pipx:

pipx install git+https://github.com/roderickch01/mcp-server-starter.git

Registrieren Sie es anschließend bei Ihrem MCP-Client. Bearbeiten Sie für Claude Desktop die Datei ~/.config/Claude/claude_desktop_config.json (Linux), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "starter": {
      "command": "mcp-server-starter"
    }
  }
}

Eine Kopie dieses Snippets befindet sich unter examples/claude_desktop_config.json. Starten Sie Ihren Client neu, woraufhin die Tools echo und add erscheinen sollten.

Was ist enthalten

Zwei Demo-Tools zur Überprüfung der Anbindung:

echo(text: str) -> str — gibt "echo: {text}" zurück
add(a: int, b: int) -> int — gibt die Summe zurück

Beide befinden sich in src/mcp_server_starter/server.py (unter 30 Zeilen).

Hinzufügen eines eigenen Tools

Öffnen Sie server.py und dekorieren Sie eine beliebige Funktion mit @mcp.tool(). Die Signatur, die Typ-Hinweise und der Docstring werden automatisch zum Schema des Tools:

@mcp.tool()
def reverse(text: str) -> str:
    """Return the input string reversed."""
    return text[::-1]

Installieren Sie es neu (pipx reinstall mcp-server-starter) und starten Sie Ihren MCP-Client neu. Das neue Tool ist nun erkennbar.

Lokale Entwicklung

git clone https://github.com/roderickch01/mcp-server-starter.git
cd mcp-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-server-starter   # runs the server over stdio