TG_MCP
A lightweight Python interface that exposes TigerGraph operations (queries, schema, vertices, edges, UDFs) as structured tools and URI-based resources for MCP agents.
Table of Contents
- Features
- Project Structure
- Installation
- Configuration
- Connecting to Claude
- Examples
- Contributing
- License
Features
- Schema Introspection
Retrieve full graph schema (vertex & edge types). - Query Execution
Run installed GSQL queries or raw GSQL strings with parameters. - Vertex & Edge Upsert
Create or update vertices and edges programmatically. - Resource URIs
Access graph objects through tgraph://vertex/... and tgraph://query/... URIs. - UDF & Algorithm Listing
Fetch installed user-defined functions and GDS algorithm catalogs.
Project Structure
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
Installation
- Clone the repo
git clone https://github.com/Muzain187/TG_MCP.git
cd TG_MCP
- Create & activate a virtual environment
python3 -m venv venv
source venv/bin/activate
- Install dependencies
Requires mcp[cli]>=1.6.0 and pyTigerGraph>=1.8.6.
Configuration
Set the following environment variables before running:
export TG_HOST=https://<your-tigergraph-host>
export TG_GRAPH=<your-graph-name>
export TG_SECRET=<your-api-secret>
These are read by config.py.
Connecting to Claude
This MCP server can be installed into the Claude Desktop client so that Claude can invoke your TigerGraph tools directly:
uv run mcp install main.py
After running the above, restart Claude Desktop and you’ll see your MCP tools available via the hammer 🛠 icon.
Examples:
Contributing
- Fork the repository
- Create a feature branch
git checkout -b feature/YourFeature
- Commit your changes
git commit -m "Add YourFeature"
- Push to branch
git push origin feature/YourFeature
- Open a Pull Request
Please ensure all new code is covered by tests and follows PEP-8 style.
License
This project is licensed under the MIT License.