Consumer Complaint Database MCP

База данных жалоб потребителей MCP

Этот репозиторий содержит локальный сервер MCP для запросов к базе данных жалоб потребителей Бюро по защите прав потребителей в сфере финансов США (CFPB). Сервер предназначен для запуска через стандартный ввод/вывод, что делает его идеальным для интеграции с такими инструментами, как Claude Desktop.

Файлы

• complaints.py – основной сервер MCP, предоставляющий единый инструмент search_complaints для извлечения записей о жалобах из API CFPB.
• pyproject.toml – Минимальные метаданные проекта и декларации зависимостей.
• claude_desktop_config.json – Пример конфигурации для запуска сервера из Claude Desktop.

Требования

• Питон 3.11+
• uv или pip для установки зависимостей

Необходимые пакеты Python перечислены в pyproject.toml и включают httpx , mcp[cli] и python-dateutil .

Настройка (необязательно)

uv run автоматически создает виртуальную среду, блокирует ваши зависимости, синхронизирует их, а затем выполняет скрипт. Если вы планируете запустить сервер с помощью uv run complaints.py , вы можете пропустить установку требований заранее.

Для пользователей, которые предпочитают предварительно устанавливать пакеты или использовать простой pip , установите зависимости с помощью uv :

Или с простым pip :

Бег

Чтобы запустить сервер непосредственно из командной строки для проведения дымового теста:

Сервер работает только через stdio и ждет запросов от клиента, поддерживающего MCP (например, Claude Desktop).

Проведение тестов

Выполните модульные тесты с помощью обнаружения unittest Python. Из корня репозитория выполните:

Для этого необходимо установить зависимости, перечисленные в pyproject.toml .

Конфигурация рабочего стола Клода

Файл claude_desktop_config.json включает пример записи, указывающей на скрипт complaints.py . Замените INSERTPATH на путь к этому репозиторию на вашем компьютере и импортируйте конфигурацию в Claude Desktop.

Ссылки

• Документация API базы данных жалоб потребителей CFPB – базовый API, используемый этим сервером MCP.
• Краткое руководство по Model Context Protocol – руководство, которое помогло создать этот пример.

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .