TigerGraph MCP сервер

Python MCP сервер от сообщества, который предоставляет операции с базой данных TigerGraph (запросы, схемы, вершины, рёбра, пользовательские функции) в виде структурированных инструментов для взаимодействия с TigerGraph базами данных на естественном языке.

Установка

Из исходного кода

git clone https://github.com/customdiscoveries/TigerGraph_MCP.git
cd TigerGraph-MCP
cp mcp_server/.env-example .env
cp mcp_server/mcp_chatbot/example-server_config.json server_config.json
installUVEnvironment.sh

Конфигурация

Claude Desktop

{
  "args": ["run", "/**Your full path goes here**/MCP-Repository/TigerGraph-MCP/main.py"]
}

Доступные инструменты

Инструмент	Описание
`schema_introspection`	Получение полной схемы графа (типы вершин и рёбер)
`query_view`	Получение списка доступных запросов, которые можно выполнить
`query_execution`	Выполнение установленных GSQL запросов или сырых GSQL строк с параметрами
`create_vertex_edge`	Создание вершин и рёбер программно
`alter_vertex`	Изменение вершины для включения поддержки векторных атрибутов
`upsert_vertex_edge`	Обновление атрибутов вершин и рёбер программно (включая векторные атрибуты)
`udf_algorithm_listing`	Получение установленных пользовательских функций и каталогов алгоритмов GDS
`displayService_Status`	Отображение статуса сервисов базы данных, показывает какие сервисы онлайн (только для админов)
`displayDetailed_Service_Status`	Предоставление детального статуса сервисов с дополнительной информацией о графе, включая вершины...
`displayComponent_Version`	Отображение всех версий компонентов, составляющих TigerGraph сервер (только для админов)
`displayCPUMemory_Usage`	Отображение использования CPU и памяти всеми компонентами TigerGraph сервера (только для админов)
`displayDiskSpace_Usage`	Отображение использования дискового пространства различными компонентами TigerGraph сервера...

Возможности

Интроспекция схем - получение полной схемы графа (типы вершин и рёбер)
Просмотр запросов - получение списка доступных запросов
Выполнение запросов - запуск установленных GSQL запросов или сырых GSQL строк с параметрами
Создание вершин и рёбер - программное создание вершин и рёбер
Изменение вершин - поддержка векторных атрибутов
Обновление вершин и рёбер - программное обновление атрибутов вершин и рёбер (включая векторные атрибуты)
Список пользовательских функций и алгоритмов - получение установленных пользовательских функций и каталогов алгоритмов GDS
Административные функции - мониторинг сервисов базы данных, версии компонентов, использование CPU/памяти/диска (требует роль 'superuser')
MCP чат-бот - интерактивный интерфейс чата с командами на естественном языке
Экспорт в CSV/JSON - экспорт результатов запросов в форматы CSV или JSON

Переменные окружения

Обязательные

TG_HOST - URL хоста TigerGraph
TG_GRAPH - имя графа TigerGraph
TG_USERNAME - имя пользователя базы данных TigerGraph
TG_PASSWORD - пароль пользователя базы данных TigerGraph
LLM_MODEL_FAMILY - семейство модели LLM - в настоящее время поддерживает 'ANTHROPIC' или 'OPENAI'

Опциональные

TG_SECRET - секрет TigerGraph (автоматически получается, если не указан)
TG_TOKEN - токен TigerGraph (автоматически получается, если не указан)
ANTHROPIC_LLM_MODEL - имя модели Anthropic LLM
ANTHROPIC_API_KEY - API ключ Anthropic
ANTHROPIC_TOKENS - лимит токенов Anthropic
OPENAI_LLM_MODEL - имя модели OpenAI LLM
OPENAI_TOKENS - лимит токенов OpenAI
OPENAI_API_KEY - API ключ OpenAI

Примеры использования

@listQueries чтобы увидеть доступные файлы результатов запросов

@<query_file_name> список содержимого файла запроса

/tools чтобы перечислить доступные инструменты в MCP сервере

/prompts чтобы перечислить доступные промпты в MCP сервере

Покажи мне схему графа

Ресурсы

GitHub Repository

Примечания

Требует TigerGraph версии >= 4.2.0 и Python >= 3.12. Административные функции требуют роль базы данных 'superuser'. Включает встроенную функциональность чат-бота и управление сессиями с автоматической обработкой SECRET и TOKEN. Поддерживает модели LLM как Anthropic Claude, так и OpenAI для интерфейса чат-бота.