Consumer Complaint Database MCP

Base de datos de quejas de consumidores MCP

Este repositorio contiene un servidor MCP exclusivamente local para consultar la base de datos de quejas de consumidores de la Oficina para la Protección Financiera del Consumidor (CFPB) de EE. UU. El servidor está diseñado para ejecutarse mediante entrada/salida estándar, lo que lo hace ideal para la integración con herramientas como Claude Desktop.

Archivos

• complaints.py – Servidor principal de MCP que expone una única herramienta, search_complaints , para recuperar registros de quejas de la API de CFPB.
• pyproject.toml – Metadatos mínimos del proyecto y declaraciones de dependencia.
• claude_desktop_config.json – Configuración de ejemplo para iniciar el servidor desde Claude Desktop.

Requisitos

• Python 3.11+
• uv o pip para instalar dependencias

Los paquetes de Python necesarios se enumeran en pyproject.toml e incluyen httpx , mcp[cli] y python-dateutil .

Configuración (opcional)

uv run crea automáticamente un entorno virtual, bloquea las dependencias, las sincroniza y luego ejecuta el script. Si planea iniciar el servidor con uv run complaints.py , puede omitir la instalación de requisitos con antelación.

Para los usuarios que prefieren preinstalar paquetes o usar pip simple, instalen las dependencias con uv :

O con pip simple:

Correr

Para iniciar el servidor directamente desde la línea de comandos para una prueba de humo:

El servidor se ejecuta únicamente en stdio y espera solicitudes de un cliente compatible con MCP (por ejemplo, Claude Desktop).

Ejecución de pruebas

Ejecute las pruebas unitarias con el descubrimiento de pruebas unitarias de Python. Desde la raíz del repositorio, ejecute:

Esto requiere que se instalen las dependencias enumeradas en pyproject.toml .

Configuración del escritorio de Claude

El archivo claude_desktop_config.json incluye una entrada de ejemplo que apunta al script complaints.py . Reemplace INSERTPATH con la ruta a este repositorio en su equipo e importe la configuración a Claude Desktop.

Referencias

• Documentación de la API de la base de datos de quejas de los consumidores de CFPB : API subyacente utilizada por este servidor MCP.
• Tutorial de inicio rápido del Protocolo de contexto de modelo : tutorial que ayudó a crear este ejemplo.

Licencia

Este proyecto está licenciado bajo la licencia MIT .