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> )
- 메타데이터와 함께 특정 그래프의 샘플 데이터를 제공합니다.

구성

.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)

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다.