Contact Book MCP Server

Un servidor sencillo de Model Context Protocol (MCP) que administra una agenda de contactos en memoria. Construido con FastMCP del SDK mcp de Pythón.

Características

Este servidor expone cuatro herramientas:

Los contactos se guardan en memoria así:

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

Nota: Los datos solo se guardan en memoria. Todos los contactos se pierden cuando el servidor se reinicia.

Related MCP server: mcp-outlook-contacts

Requisitos

• Python 3.10+

• uv (recomendad para ejecutar el servidor)

Instalación

1. Clona este repositorio:

   git clone <your-repo-url>
   cd contact_book_server_mcp

2. Insta las dependencias:

   pip install -r requirements.txt

   O, si se usa uv (recomendad; no hay que instalar nada a mando — ver abalo).

Ejecución del servidor

MCP Inspector (para prubas/desarrollo)

uv run --with mcp mcp dev server.py

Esto inicia el servidor y abre el MCP Inspector en tu navegador, donde puedes probar cada herramienta de forma interactiva.

Modo independiente

python server.py

Ejemplo de uso

1. Agrega un contacto

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

2. Obtén un contacto

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

3. Busca contactos

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

4. Actiliza un sistema

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

Estdo del proyecto

✅ Las cuatro herramientas están implementadas y probadas con el MCP Inspector.

Mostradas posibles

• Agrega una herramienta delete_contact.

• Agrega una herramienta list_all_contacts.

• Persiste los contactos en un archivo JSON o en una base de datos, en lugar del almacenamiento en memoria.