OpenTK Model Context Protocol Server

OpenTK 모델 컨텍스트 프로토콜 서버

중요 저작자 표시 : 이 MCP 서버는 Bert Hubert 가 개발한 뛰어난 OpenTK 프로젝트를 기반으로 제작되었습니다. OpenTK 프로젝트는 사용자 친화적인 인터페이스를 통해 네덜란드 의회 데이터에 대한 전례 없는 접근성을 제공합니다. Bert의 글 " Welkom bij OpenTK" 에서 이 프로젝트에 대한 자세한 내용을 확인하세요. 데이터 접근 및 처리에 대한 모든 공로는 Bert Hubert와 그의 정부 오픈 데이터 개발에 대한 공헌에 있습니다.

표준화된 인터페이스를 통해 대규모 언어 모델(LLM)과 네덜란드 의회 데이터를 연결합니다. 이 MCP 서버는 네덜란드 의회 문서, 토론, 그리고 의회 의원 정보(Tweede Kamer)에 대한 접근을 제공합니다.

실제 자연어 상호 작용의 예

예시 1: AI 정책에 대한 정당 입장 비교

사용자 질의: "네덜란드 하원에서 야당인 PvdA, GroenLinks, Volt와 여당인 BBB의 AI 분야 활동을 비교할 때, 지난 1년간 보여준 입장과 견해에 부합하는 단기적인 협력 방안은 무엇일까요? OpenTK의 자료를 참고해 주세요."

예시 2: 기후 정책에 대한 의회 논의 조사

사용자 질의: "네덜란드의 기후 정책과 배출량 감축 목표에 대한 최근 의회 토론을 분석하고 싶습니다. 지난 6개월 동안 주요 논의 내용과 각 정당의 주요 입장을 파악하는 데 도움을 주시겠습니까?"

예 3: 특정 의원의 투표 기록에 대한 정보

사용자 질의: "피터 옴치히트 의원의 의료 개혁 법안에 대한 투표 기록은 어떠하며, 그의 입장은 다른 무소속 의원들과 어떻게 다릅니까? 이 주제에 대해 발의한 안건이 있습니까?"

예제 4: 최근 주택 관련 법률 개발 사항 찾기

사용자 질의: "지난 한 해 동안 저렴 주택 관련 법률에 관한 가장 중요한 의회 문서와 논의는 무엇입니까? 저는 특히 임대 시장 위기를 해결하는 제안에 관심이 있습니다."

예제 5: 특정 위원회 위원을 보유한 국회의원 찾기

사용자 질의: "현재 재무위원회와 경제위원회에서 활동하는 국회의원은 누구입니까? 이들은 어떤 정당을 대표하며, 최근 공동 이니셔티브를 제출했습니까?"

예시 6: 디지털 보안에 관한 향후 의회 활동 식별

사용자 질의: "다음 달 사이버 보안 및 디지털 인프라 관련 위원회 회의나 토론이 예정되어 있습니까? 어떤 장관들이 참석하며 구체적으로 어떤 주제를 다룰 예정입니까?"

프로젝트 개념

OpenTK 프로젝트는 표준화된 인터페이스를 통해 네덜란드 의회 데이터에 접근할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 대규모 언어 모델(LLM)과 네덜란드 의회 정보 시스템을 연결하는 다리 역할을 하며, AI 비서가 의회 문서, 토론, 의원 정보를 검색, 조회 및 분석할 수 있도록 지원합니다.

이 서버는 @modelcontextprotocol/sdk 사용하여 AI 모델과 외부 데이터 소스 간의 구조화된 통신을 지원하는 MCP 사양을 구현합니다. OpenTK는 잘 정의된 도구와 엔드포인트를 통해 의회 데이터를 노출함으로써 AI 비서가 다음과 같은 작업을 수행할 수 있도록 지원합니다.

1. 복잡한 쿼리를 사용하여 의회 문서 검색
2. 국회의원에 대한 정보에 접근하세요
3. 다양한 형식의 공식 문서를 검색하고 문서의 전체 내용을 읽어보세요.
4. 의회 활동 및 절차 분석
5. 입법 사례 및 정부 공약 추적

이 프로젝트는 Bert Hubert의 tkconv 서비스를 기본 데이터 소스로 활용하는데, 이는 네덜란드 의회의 공식 API보다 접근성이 높은 API를 제공합니다.

설치

1. NPM 패키지와 함께 Claude Desktop 사용

Claude 구성 파일을 업데이트하세요(~/Library/Application Support/Claude/claude_desktop_config.json):

지엑스피1

2. 출처로부터

복제 저장소:

종속성 설치:

프로젝트 빌드:

서버를 시작합니다:

2. Claude Desktop 구성

Claude 구성 파일을 업데이트하세요.

/absolute/path/to/your/opentk-mcp/ 실제 설치 경로로 바꿔야 합니다.

검색 기능

검색 기능은 특히 정교하며 다음을 지원합니다.

• 간단한 키워드 검색: kunstmatige intelligentie
• 정확한 구문 검색: "kunstmatige intelligentie"
• 제외 검색: Hubert NOT Bruls
• 부울 연산자: OR , NEAR()

구현은 다양한 예외 사례를 처리합니다.

• 검색 쿼리에서 따옴표를 유지합니다.
• 적절한 콘텐츠 유형 헤더를 사용합니다.
• API 오류에 대한 대체 메커니즘을 구현합니다.
• 의미 있는 오류 메시지를 제공합니다

오류 처리

API 서비스에는 강력한 오류 처리 기능이 포함되어 있습니다.

• API 오류(4xx, 5xx)의 우아한 처리
• 복잡한 쿼리가 실패하면 단순화된 쿼리로 대체
• 디버깅을 위한 자세한 오류 메시지
• stderr에 대한 적절한 로깅(stdout이 아닌, stdio 전송을 중단시킴)

구성

이 서버는 Bert Hubert의 tkconv 서비스를 주요 데이터 소스로 사용하여 연결하며, 이 서비스는 공식 네덜란드 의회 API보다 접근성이 뛰어난 API를 제공합니다. Bert Hubert가 개발한 이 서비스는 네덜란드 의회 데이터를 개발자 친화적인 형식으로 수집, 정리 및 제공하는 중요한 작업을 수행합니다. 저희 MCP 서버는 이러한 기반을 바탕으로 AI 비서가 이 귀중한 데이터와 상호 작용할 수 있는 표준화된 인터페이스를 구축합니다.

특허

MIT

결론

OpenTK MCP 서버는 네덜란드 의회 데이터에 대한 강력하고 체계적인 인터페이스를 제공하여 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 AI 지원자가 데이터에 접근할 수 있도록 지원합니다. 모듈식 설계, 포괄적인 API, 그리고 철저한 테스트를 통해 AI 지원 연구, 분석 및 정보 검색을 위한 의회 정보에 대한 안정적인 접근을 보장합니다.

구성이 완료되면 Claude는 OpenTK MCP 서버를 통해 네덜란드 의회 데이터에 접근할 수 있습니다. 이 서버는 위 "사용법" 섹션에 설명된 모든 도구를 제공합니다.