Сервер GraphDB MCP

Сервер Model Context Protocol, который обеспечивает доступ только для чтения к Ontotext GraphDB. Этот сервер позволяет LLM исследовать RDF-графы и выполнять запросы SPARQL к экземпляру GraphDB.

Компоненты

Инструменты

• sparqlQuery

  • Выполнение запросов SPARQL к подключенному репозиторию GraphDB

  • Вход:

    • 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 :

GRAPHDB_ENDPOINT=http://localhost:7200
GRAPHDB_REPOSITORY=myRepository
GRAPHDB_USERNAME=username
GRAPHDB_PASSWORD=password

В качестве альтернативы вы можете указать конечную точку и репозиторий в качестве аргументов командной строки:

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

Аргументы командной строки имеют приоритет над переменными среды.

Использование с Claude Desktop

Чтобы использовать этот сервер с приложением Claude Desktop, добавьте следующую конфигурацию в раздел «mcpServers» вашего claude_desktop_config.json :

{
  "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, которые вы можете выполнить с помощью этого сервера:

1. Перечислите все классы в онтологии:

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

2. Перечислите все свойства для определенного класса:

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

3. Подсчет экземпляров по классу:

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 лицензирован по лицензии GPL-3.0. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии GNU GPL-3.0.