propublica-npo-mcp

ProPublica Nonprofit Explorer API를 노출하여 엄선된 비영리 단체 및 신고 요약을 제공하는 MCP 서버입니다.

설치

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 색인을 검색하며, 주(state), NTEE 주요 카테고리, 501(c) 하위 유형 및 페이지 필터를 선택적으로 사용할 수 있습니다.

get_organization은 조직 메타데이터와 기본적으로 가장 최근 신고서 최대 5건에 대한 요약을 반환합니다. 원시 업스트림 페이로드를 가져오려면 verbose: true를 전달하세요.

list_organization_filings는 EIN에 대한 모든 신고서를 최신순으로 반환합니다. 기본 출력은 요약된 형태이며, verbose: true를 사용하면 원시 신고서 배열을 반환합니다.

compare_nonprofits는 2~5개의 조직을 최신 신고서 데이터를 사용하여 나란히 비교하며, EIN별 404 오류는 행 수준 오류로 유지합니다.

참고 사항

이 서버는 1시간 TTL이 적용된 100개 항목의 메모리 내 LRU 캐시를 사용합니다. 각 업스트림 요청에는 15초의 타임아웃이 있으며 네트워크 또는 5xx 오류 발생 시 한 번 재시도합니다. ProPublica는 공개되어 있지만 여전히 속도 제한이 적용됩니다. 429 오류가 발생하면 루프를 돌리지 말고 잠시 기다린 후 재시도하세요.

지원

이 프로젝트가 비영리 단체 조사나 멋진 에이전트를 구축하는 데 도움이 되었다면 커피 한 잔을 후원해 주세요! 지속적인 업데이트에 큰 힘이 됩니다.

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

라이선스

MIT 라이선스 - Ian Shen 제작.