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 비서가 다음과 같은 작업을 수행할 수 있도록 지원합니다.

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

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

설치

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

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

지엑스피1

2. 출처로부터

복제 저장소:

git clone https://github.com/r-huijts/opentk-mcp.git
cd opentk-mcp

종속성 설치:

npm install

프로젝트 빌드:

npm run build

서버를 시작합니다:

npm start

2. Claude Desktop 구성

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

{
  "mcpServers": {
    "opentk-mcp-local": {
      "command": "node",
      "args": [
        "/absolute/path/to/your/opentk-mcp/dist/index.js"
      ]
    }
  }
}

/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 서버를 통해 네덜란드 의회 데이터에 접근할 수 있습니다. 이 서버는 위 "사용법" 섹션에 설명된 모든 도구를 제공합니다.

OpenTK Model Context Protocol Server