TG_MCP

Una interfaz Python liviana que expone las operaciones de TigerGraph (consultas, esquemas, vértices, aristas, UDF) como herramientas estructuradas y recursos basados en URI para agentes MCP.

Tabla de contenido

1. Características

2. Estructura del proyecto

3. Instalación

4. Configuración

5. Conectando con Claude

6. Ejemplos

7. Contribuyendo

8. Licencia

Related MCP server: buddy

Características

• Introspección de esquemas
  Recupere el esquema gráfico completo (tipos de vértice y arista).

• Ejecución de consultas
  Ejecute consultas GSQL instaladas o cadenas GSQL sin procesar con parámetros.

• Inserción de vértices y aristas
  Crear o actualizar vértices y aristas mediante programación.

• URI de recursos
  Acceda a los objetos gráficos a través de los URI tgraph://vertex/... y tgraph://query/...

• Listado de UDF y algoritmos
  Obtenga funciones definidas por el usuario instaladas y catálogos de algoritmos GDS.

Estructura del proyecto

TG_MCP/
├── config.py            # Environment config (HOST, GRAPH, SECRET)
├── tg_client.py         # Encapsulates TigerGraphConnection and core operations
├── tg_tools.py          # `@mcp.tool` definitions exposing client methods
├── tg_resources.py      # `@mcp.resource` URI handlers
├── main.py              # MCP app bootstrap (`mcp.run()`)
├── pyproject.toml       # Project metadata & dependencies
├── LICENSE              # MIT License
└── .gitignore           # OS/Python ignore rules

Instalación

1. Clonar el repositorio

   git clone https://github.com/Muzain187/TG_MCP.git
   cd TG_MCP

2. Crear y activar un entorno virtual

   python3 -m venv venv
   source venv/bin/activate

3. Instalar dependencias

   pip install .

   Requiere mcp[cli]>=1.6.0 y pyTigerGraph>=1.8.6 .

Configuración

Establezca las siguientes variables de entorno antes de ejecutar:

export TG_HOST=https://<your-tigergraph-host>
export TG_GRAPH=<your-graph-name>
export TG_SECRET=<your-api-secret>

Estos son leídos por config.py .

Conectando con Claude

Este servidor MCP se puede instalar en el cliente de escritorio Claude para que Claude pueda invocar sus herramientas TigerGraph directamente:

uv run mcp install main.py

Después de ejecutar lo anterior, reinicie Claude Desktop y verá sus herramientas MCP disponibles a través del ícono del martillo 🛠.

Ejemplos:

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

   git checkout -b feature/YourFeature

3. Confirme sus cambios

   git commit -m "Add YourFeature"

4. Empujar a la rama

   git push origin feature/YourFeature

5. Abrir una solicitud de extracción

Asegúrese de que todo el código nuevo esté cubierto por pruebas y siga el estilo PEP-8.

Licencia

Este proyecto está licenciado bajo la licencia MIT .