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

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

파일

• complaints.py – CFPB API에서 불만 기록을 검색하기 위한 단일 도구인 search_complaints 제공하는 주요 MCP 서버입니다.

• 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 로 서버를 실행하려는 경우, 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으로 가져오세요.

참고문헌

• CFPB 소비자 불만 데이터베이스 API 문서 – 이 MCP 서버에서 사용하는 기본 API입니다.

• 모델 컨텍스트 프로토콜 빠른 시작 튜토리얼 – 이 예제를 만드는 데 도움이 된 튜토리얼입니다.

특허

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