OpenBudget MCP 서버

OpenBudget API에 대한 액세스를 제공하는 MCP 서버로, 다양한 예산 관련 데이터 세트를 쿼리하고 검색할 수 있습니다.

설명

이 프로젝트는 이스라엘의 OpenBudget 데이터와 연동되는 FastMCP 서버를 제공합니다. 이를 통해 예산 데이터, 계약 및 지원 정보에 쉽게 접근할 수 있으며, OpenBudget API와 MCP 클라이언트를 연결하는 다리 역할을 합니다.

이 프로젝트는 OpenBudget/BudgetKey 팀의 놀라운 노력 덕분에만 가능합니다.

특징

이스라엘 정부 예산 데이터에 대한 전체 액세스
OpenBudget API와의 실시간 통합
다양한 데이터 범주에 대한 포괄적인 검색 기능
과거 예산 추적 및 분석
계약 및 지원 결제 정보 검색
클라이언트 애플리케이션을 위한 사용하기 쉬운 MCP 인터페이스

요구 사항

Python 3.10 이상
uv 패키지 관리자

설치

지엑스피1

용법

다음 방법 중 하나를 사용하여 서버를 설치하고 실행하세요.

Visual Studio Code(Copilot 사용) : vscode/mcp.json 파일로 이동하여 {YOUR-LOCAL-PATH}를 저장소를 복제한 경로로 바꾸세요. VSCode가 서버를 자동으로 검색합니다. 만약 자동으로 검색되지 않으면 vscode://settings/mcp 에서 MCP 및 MCP.Discovery를 활성화했는지 확인하세요. vscode copilot에서 에이전트 모드를 활성화하세요.
Claude AI Assistant 와 함께 사용:

fastmcp install server.py

MCP Inspector로 테스트하려면( MCP Inspector 에서 방법을 알아보세요):

fastmcp dev server.py

사용 가능한 데이터 세트

사용 가능한 데이터 세트는 다음과 같습니다.

예산_항목_데이터
소득_항목_데이터
지원_데이터
계약 데이터
엔티티_데이터
예산 변경 요청 데이터
예산 변경 거래 데이터

MCP 도구

데이터셋 정보 가져오기

열과 데이터베이스 스키마를 포함한 데이터 세트의 구조에 대한 정보를 가져옵니다.

검색_데이터셋

데이터 세트 내에서 전체 텍스트 검색을 수행합니다.

쿼리_데이터셋

데이터 세트에 대해 SQL 쿼리를 실행합니다.

MCP 리소스

사용 가능한 데이터 세트

사용 가능한 모든 데이터 세트 목록을 가져옵니다.

오류 처리

다음의 경우 도구는 적절한 오류 메시지를 반환합니다.

잘못된 데이터 세트 이름
잘못된 SQL 쿼리
API 요청 실패
네트워크 연결 문제

API 문서

이 서버는 OpenBudget API를 기반으로 합니다. API 엔드포인트 및 데이터 구조에 대한 자세한 내용은 budgetkey.yaml 의 OpenAPI 사양을 참조하세요.

기여하다

DataGov Israel MCP 서버 개선을 위한 여러분의 참여를 환영합니다. 새로운 도구 추가, 기존 기능 개선, 문서 개선 등 어떤 목적이든 여러분의 의견은 소중합니다.

다른 MCP 서버와 구현 패턴의 예는 Model Context Protocol 서버 저장소를 참조하세요.

특허

이 프로젝트는 다음 두 가지 라이선스를 받았습니다.

MIT 라이센스
크리에이티브 커먼즈 저작자표시-동일조건변경허락 4.0 국제 라이선스

자세한 내용은 LICENSE 파일을 참조하세요.

OpenBudget MCP Server

Integrations