소비자 불만 데이터베이스 MCP

이 저장소에는 미국 소비자금융보호국(CFPB) 소비자 불만 데이터베이스를 쿼리하기 위한 로컬 전용 MCP 서버가 포함되어 있습니다. 이 서버는 표준 입출력(SIO)을 통해 실행되도록 설계되어 Claude Desktop과 같은 도구와 통합하기에 이상적입니다.

complaints.py – CFPB API에서 불만 기록을 검색하기 위한 단일 도구인 search_complaints 제공하는 주요 MCP 서버입니다.
pyproject.toml – 최소한의 프로젝트 메타데이터와 종속성 선언.
claude_desktop_config.json – Claude Desktop에서 서버를 시작하기 위한 구성 예.

필수 Python 패키지는 pyproject.toml 에 나열되어 있으며 httpx , mcp[cli] 및 python-dateutil 포함됩니다.

uv run 자동으로 가상 환경을 생성하고, 종속성을 잠그고, 동기화한 다음 스크립트를 실행합니다. uv run complaints.py 로 서버를 실행하려는 경우, requirements를 미리 설치하지 않아도 됩니다.

패키지를 미리 설치하거나 일반 pip 사용하는 것을 선호하는 사용자의 경우 uv 사용하여 종속성을 설치합니다.

지엑스피1

또는 일반 pip 사용하면:

pip install -r pyproject.toml

스모크 테스트를 위해 명령줄에서 직접 서버를 시작하려면:

uv run complaints.py

서버는 stdio로만 실행되며 MCP를 인식하는 클라이언트(예: Claude Desktop)의 요청을 기다립니다.

Python의 unittest 검색 기능을 사용하여 단위 테스트를 실행합니다. 저장소 루트에서 다음을 실행합니다.

python -m unittest discover -s tests -v

이렇게 하려면 pyproject.toml 에 나열된 종속성이 설치되어 있어야 합니다.

claude_desktop_config.json 파일에는 complaints.py 스크립트를 가리키는 예제 항목이 포함되어 있습니다. INSERTPATH 사용자 컴퓨터의 이 저장소 경로로 바꾸고 구성을 Claude Desktop으로 가져오세요.

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

security - not tested

license - permissive license

quality - not tested

사용자가 자연어로 CFPB 소비자 불만 데이터베이스를 쿼리하고 CFPB API를 통해 금융 소비자 불만 기록을 검색할 수 있는 로컬 MCP 서버입니다.

Consumer Complaint Database MCP