Mcp-Brasil/mcp-brasil

해결하는 문제

mcp-brasil은 AI 에이전트(Claude, GPT, Copilot 등)가 브라질 정부의 70개 이상의 공공 데이터 소스에 직접 접근할 수 있도록 해주는 MCP(Model Context Protocol) 서버입니다. 분산된 정부 포털을 수동으로 탐색할 필요 없이, 경제, 입법, 사법, 사회 데이터를 통합된 인터페이스로 접근할 수 있도록 합니다.

작동 방식

이 프로젝트는 '기능별 패키징' 아키텍처를 구현하며, 자동 등록 시스템을 갖추고 있습니다. 세 가지 유형의 데이터 접근 방식을 제공합니다:

• REST 패스스루: 공식 정부 API에 비동기 HTTP 요청을 보내며, 출력은 Pydantic을 통해 구조화됩니다.
• 로컬 데이터셋: 대용량 데이터셋(예: TSE 선거 데이터, SIAPA 부동산 기록)은 CSV/ZIP 형식으로 다운로드하여 내장된 DuckDB 로컬 캐시에 저장해 고성능 SQL 쿼리를 가능하게 합니다.
• 지능형 에이전트: 도구, 프롬프트, 리소스를 결합해 복잡한 워크플로우(예: 공식 문서 작성)를 처리합니다.

발견(기능별 BM25 검색), 쿼리의 배치 실행, 여러 다른 API 간 데이터를 교차 참조할 수 있는 쿼리 플래너를 포함한 '스마트 툴'도 제공합니다.

대상 사용자

• AI 에이전트 개발자: 연구자, 기자, 분석가가 신뢰할 수 있는 브라질 정부 데이터를 활용할 수 있도록 도구를 개발하는 사람.
• 데이터 분석가 및 연구자: 각 데이터 소스에 맞춰 맞춤형 API 통합을 작성하지 않고도 LLM을 사용해 공공 데이터를 질의하고자 하는 사용자.
• 시민 기술 개발자: 투명성 중심의 기술 기반 애플리케이션을 개발하는 사람.

주요 특징

• 광범위한 커버리지: 경제, 건강, 교육, 사법 등 15개 주제 분야를 아우르는 70개 기능에 걸쳐 533개의 도구 제공.
• 하이브리드 데이터 접근: 실시간 API 호출과 대용량 데이터셋용 로컬 DuckDB 기반 SQL 엔진을 결합.
• 교차 참조 가능: 여러 소스의 데이터를 결합한 실행 계획을 생성할 수 있음(예: 의원의 지출 내역과 투표 기록 통합).
• 저장벽 접근: 70개 API 중 66개는 API 키가 필요 없어 즉시 시작 가능.
• 광범위한 통합: Claude Desktop, VS Code/Cursor, 표준 HTTP 전송 방식을 지원.