OpenBudget MCP 서버

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

설명

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

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

특징

• 이스라엘 정부 예산 데이터에 대한 전체 액세스

• OpenBudget API와의 실시간 통합

• 다양한 데이터 범주에 대한 포괄적인 검색 기능

• 과거 예산 추적 및 분석

• 계약 및 지원 결제 정보 검색

• 클라이언트 애플리케이션을 위한 사용하기 쉬운 MCP 인터페이스

요구 사항

• Python 3.10 이상

• uv 패키지 관리자

설치

지엑스피1

용법

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

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

2. Claude AI Assistant 와 함께 사용:

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

사용 가능한 데이터 세트

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

• 예산_항목_데이터

• 소득_항목_데이터

• 지원_데이터

• 계약 데이터

• 엔티티_데이터

• 예산 변경 요청 데이터

• 예산 변경 거래 데이터

MCP 도구

데이터셋 정보 가져오기

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

검색_데이터셋

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

쿼리_데이터셋

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

MCP 리소스

사용 가능한 데이터 세트

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

오류 처리

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

• 잘못된 데이터 세트 이름

• 잘못된 SQL 쿼리

• API 요청 실패

• 네트워크 연결 문제

API 문서

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

기여하다

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

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

특허

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

• MIT 라이센스

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

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