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

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

Файлы

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

Related MCP server: Firebase Realtime Database API MCP Server

Требования

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

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

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

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

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

uv pip install -r pyproject.toml

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

pip install -r pyproject.toml

Бег

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

uv run complaints.py

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

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

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

python -m unittest discover -s tests -v

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

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

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