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
- Características
- Estructura del proyecto
- Instalación
- Configuración
- Conectando con Claude
- Ejemplos
- Contribuyendo
- Licencia
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
- Clonar el repositorio
git clone https://github.com/Muzain187/TG_MCP.git
cd TG_MCP
- Crear y activar un entorno virtual
python3 -m venv venv
source venv/bin/activate
- Instalar dependencias
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
- Bifurcar el repositorio
- Crear una rama de características
git checkout -b feature/YourFeature
- Confirme sus cambios
git commit -m "Add YourFeature"
- Empujar a la rama
git push origin feature/YourFeature
- 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 .