Contact Book MCP Server

Ein einfacher Server für das Model Context Protocol (MCP), der ein In-Memory-Kontaktbuch verwaltet. Erstellt mit FastMCP aus dem mcp Python SDK.

Funktionen

Dieser Server stellt vier Tools bereit:

Kontakte werden im Arbeitsspeicher wie folgt gespeichert:

contacts: dict[str, dict]  # name -> {"phone": ..., "email": ...}

Hinweis: Die Daten werden nur im Arbeitsspeicher gespeichert. Alle Kontakte gehen verloren, wenn der Server neu gestartet wird.

Related MCP server: mcp-outlook-contacts

Anforderungen

• Python 3.10+

• uv (empfohlen für die Ausführung des Servers)

Installation

1. Klonen Sie dieses Repository:

   git clone <your-repo-url>
   cd contact_book_server_mcp

2. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt

   Oder, wenn Sie uv verwenden (empfohlen, keine manuelle Installation erforderlich – siehe unten).

Ausführen des Servers

Mit dem MCP Inspector (zum Testen/Entwickeln)

uv run --with mcp mcp dev server.py

Dadurch wird der Server gestartet und der MCP Inspector in Ihrem Browser geöffnet, in dem Sie jedes Tool interaktiv testen können.

Eigenständiger Betrieb

python server.py

Anwendungsbeispiel

1. Einen Kontakt hinzufügen

   add_contact(name="Humna Fahad", phone="03001234567", email="humna@test.com")
   → "Contact 'Humna Fahad' added successfully."

2. Einen Kontakt abrufen

   get_contact(name="Humna Fahad")
   → {"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}

3. Kontakte suchen

   search_contacts(query="Hum")
   → [{"name": "Humna Fahad", "phone": "03001234567", "email": "humna@test.com"}]

4. Einen Kontakt aktualisieren

   update_contact(name="Humna Fahad", phone="03009998888", email="humna@updated.com")
   → "Contact 'Humna Fahad' updated successfully."

Projektstatus

✅ Alle vier Tools wurden implementiert und über den MCP Inspector getestet.

Mögliche Verbesserungen

• Ein delete_contact-Tool hinzufügen.

• Ein list_all_contacts-Tool hinzufügen.

• Kontakte in einer JSON-Datei oder einer Datenbank speichern, anstatt sie nur im Arbeitsspeicher zu halten.