propublica-npo-mcp

MCP-сервер, предоставляющий доступ к API ProPublica Nonprofit Explorer с отобранными данными о некоммерческих организациях и сводками их отчетности.

Установка

npm install

Related MCP server: Charity MCP Server

Запуск

npm run start

Для локальной разработки:

npm run dev

Конфигурация Claude Desktop / Cline

{
  "mcpServers": {
    "propublica-npo": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/propublica-npo-mcp/src/index.ts"]
    }
  }
}

Инструменты

search_nonprofits выполняет поиск в индексе ProPublica Nonprofit Explorer по названию или ключевому слову с дополнительными фильтрами по штату, основной категории NTEE, подтипу 501(c) и страницам.

get_organization возвращает метаданные организации и по умолчанию краткую сводку до пяти последних отчетов. Установите verbose: true, чтобы получить необработанные данные от вышестоящего API.

list_organization_filings возвращает все отчеты для EIN, начиная с самых новых. По умолчанию вывод является сокращенным; verbose: true возвращает полные массивы данных об отчетности.

compare_nonprofits сравнивает от 2 до 5 организаций, используя их последние отчеты с данными, при этом ошибки 404 для конкретных EIN отображаются как ошибки на уровне строк.

Примечания

Сервер использует LRU-кэш в оперативной памяти на 100 записей с временем жизни (TTL) 1 час. Каждый запрос к вышестоящему API имеет тайм-аут 15 секунд и одну попытку повтора при сетевых ошибках или ошибках 5xx. Данные ProPublica являются публичными, но имеют ограничения по частоте запросов; если вы получили ошибку 429, подождите и повторите запрос, не создавая бесконечный цикл.

Поддержка

Если этот проект помогает вам в исследовании некоммерческих организаций или создании полезных агентов, поддержите меня чашкой кофе! Это помогает выпускать обновления.

https://paypal.me/2b3/5

Лицензия

Лицензия MIT — создано Ian Shen.