TG_MCP

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

1. Features
2. Project Structure
3. Installation
4. Configuration
5. Connecting to Claude
6. Examples
7. Contributing
8. 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

Installation

1. Clone the repo
   git clone https://github.com/Muzain187/TG_MCP.git cd TG_MCP
2. Create & activate a virtual environment
   python3 -m venv venv source venv/bin/activate
3. Install dependencies
   pip install .

   Requires mcp[cli]>=1.6.0 and pyTigerGraph>=1.8.6.

Configuration

Set the following environment variables before running:

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:

After running the above, restart Claude Desktop and you’ll see your MCP tools available via the hammer 🛠 icon.

Examples:

Contributing

1. Fork the repository
2. Create a feature branch
   git checkout -b feature/YourFeature
3. Commit your changes
   git commit -m "Add YourFeature"
4. Push to branch
   git push origin feature/YourFeature
5. 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.