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

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

Файлы

• complaints.py – основной сервер MCP, предоставляющий единый инструмент search_complaints для извлечения записей о жалобах из API CFPB.

• pyproject.toml – Минимальные метаданные проекта и декларации зависимостей.

• claude_desktop_config.json – Пример конфигурации для запуска сервера из Claude Desktop.

Related MCP server: USA Spending 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.

Ссылки

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

• Краткое руководство по Model Context Protocol – руководство, которое помогло создать этот пример.

Лицензия

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