GraphDB MCP 서버

Ontotext GraphDB에 대한 읽기 전용 액세스를 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 RDF 그래프를 탐색하고 GraphDB 인스턴스에 대해 SPARQL 쿼리를 실행할 수 있습니다.

구성 요소

도구

sparql쿼리
- 연결된 GraphDB 저장소에 대해 SPARQL 쿼리를 실행합니다.
- 입력:
  - query (문자열): 실행할 SPARQL 쿼리
  - graph (문자열, 선택 사항): 대상에 대한 특정 그래프 IRI
  - format (문자열, 선택 사항): 응답 형식(json, xml, csv)
- 모든 쿼리는 읽기 전용 모드로 실행됩니다.
리스트그래프
- 저장소에서 사용 가능한 모든 그래프를 나열합니다.
- 입력 매개변수가 필요하지 않습니다

자원

서버는 저장소 데이터에 대한 다양한 보기를 제공합니다.

클래스 목록 ( graphdb://<host>/repository/<repo>/classes )
- 저장소에서 발견된 모든 RDF 클래스를 개수와 함께 나열합니다.
술어 ( graphdb://<host>/repository/<repo>/predicates )
- 사용 횟수와 함께 모든 술어(속성)를 나열합니다.
통계 ( graphdb://<host>/repository/<repo>/stats )
- 주어, 술어, 목적어 및 삼중항의 개수를 제공합니다.
샘플 데이터 ( graphdb://<host>/repository/<repo>/sample )
- 저장소에서 트리플 샘플을 보여줍니다.
그래프 콘텐츠 ( graphdb://<host>/repository/<repo>/graph/<graphUri> )
- 메타데이터와 함께 특정 그래프의 샘플 데이터를 제공합니다.

Related MCP server: mcp-graphql

구성

.env 파일을 생성하여 환경 변수를 사용하여 서버를 구성할 수 있습니다.

지엑스피1

또는 명령줄 인수로 엔드포인트와 저장소를 제공할 수 있습니다.

node dist/index.js http://localhost:7200 myRepository

명령줄 인수는 환경 변수보다 우선합니다.

Claude Desktop과 함께 사용

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

{ "mcpServers": { "graphdb": { "command": "node", "args": [ "/path/to/mcp-server-graphdb/dist/index.js" ], "env": { "GRAPHDB_ENDPOINT": "http://localhost:7200", "GRAPHDB_REPOSITORY": "myRepository", "GRAPHDB_USERNAME": "username", "GRAPHDB_PASSWORD": "password" } } } }

해당 값을 사용자의 특정 GraphDB 구성으로 바꾸세요.

설치

# Clone the repository git clone https://github.com/yourname/mcp-server-graphdb.git cd mcp-server-graphdb # Install dependencies yarn install # Build the project yarn build

SPARQL 쿼리 예시

이 서버에서 실행할 수 있는 몇 가지 SPARQL 쿼리 예는 다음과 같습니다.

온톨로지의 모든 클래스를 나열하세요.

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT DISTINCT ?class ?label WHERE { { ?class a rdfs:Class } UNION { ?class a owl:Class } OPTIONAL { ?class rdfs:label ?label } } ORDER BY ?class

특정 클래스의 모든 속성을 나열합니다.

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#> SELECT ?property ?label ?range WHERE { ?property rdfs:domain <http://example.org/YourClass> . OPTIONAL { ?property rdfs:label ?label } OPTIONAL { ?property rdfs:range ?range } } ORDER BY ?property

클래스별로 인스턴스를 계산합니다.

PREFIX rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> SELECT ?class (COUNT(?instance) AS ?count) WHERE { ?instance a ?class } GROUP BY ?class ORDER BY DESC(?count)