Dictionary Lookup MCP Server

Ein minimaler Model Context Protocol-Server, erstellt mit dem offiziellen Python SDK. Er stellt ein Tool namens define bereit, das die Definition eines englischen Wortes über die kostenlose dictionaryapi.dev-API nachschlägt.

Dieses Projekt wurde als Lernübung erstellt, um zu verstehen, wie MCP-Server aufgebaut sind, wie sie mit Clients kommunizieren und wie man einen öffentlich bereitstellt.

Was es tut

• Stellt ein einzelnes Tool bereit: define(word: str) -> str

• Gibt für ein Wort die Wortart und die Definition zurück

• Kein API-Schlüssel oder Authentifizierung erforderlich

Related MCP server: Hello World MCP FastAPI Endpoint

Voraussetzungen

• Python 3.10+

• uv (empfohlen) oder pip

Einrichtung (lokal)

# 1. Clone this repo
git clone <your-repo-url>
cd my-mcp-server

# 2. Install dependencies
uv sync

Lokal ausführen

Option A – MCP Inspector (visuelles Testwerkzeug, am einfachsten für Anfänger):

uv run mcp dev server.py

Dies öffnet einen browserbasierten Inspector, in dem Sie das define-Tool direkt aufrufen und die Anfrage/Antwort sehen können, ohne einen vollständigen AI-Client zu benötigen.

Option B – Mit Claude Desktop verbinden:

Fügen Sie dies zu Ihrer Claude-Desktop-Konfigurationsdatei (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "dictionary-lookup": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/my-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Starten Sie Claude Desktop neu und fragen Sie dann etwa: „Verwenden Sie das Wörterbuch-Tool, um ‚ephemeral‘ zu definieren."

Verwendungsbeispiel

Eingabe: define("ephemeral") Ausgabe: ephemeral (adjective): lasting for a very short time.

Bereitstellung

Dieser Server ist auf Smithery veröffentlicht: <link once deployed>

Um eine eigene Kopie bereitzustellen:

1. Übertragen Sie dieses Repository auf GitHub.

2. Stellen Sie sicher, dass server.py den streamable-http-Transport für Remote-Hosting unterstützt.

3. Hosten Sie es (z. B. Render/Railway) oder nutzen Sie den Veröffentlichungsprozess von Smithery.

4. Wählen Sie auf Smithery „Publish via URL“ und zeigen Sie auf den Endpunkt Ihres gehosteten Servers.

Warum dieses Projekt

Erstellt, um die Grundlagen von MCP zu lernen: wie ein Client die Tools eines Servers entdeckt, wie ein Tool-Aufruf durchgeführt und beantwortet wird und wie ein funktionierender Server über einen Marktplatz wie Smithery öffentlich geteilt wird.