TigerGraph操作接口

TG_MCP

一个轻量级的Python接口，将TigerGraph操作（查询、模式、顶点、边、UDF）作为结构化工具和基于URI的MCP代理资源公开。

目录

1. 特性
2. 项目结构
3. 安装
4. 配置
5. 连接到克劳德
6. 例子
7. 贡献
8. 许可证

特性

• 图式反思
  检索完整的图形模式（顶点和边类型）。

• 查询执行
  运行已安装的GSQL查询或带有参数的原始GSQL字符串。

• 顶点和边缘向上
  以编程方式创建或更新顶点和边。

• 资源URI
  通过以下方式访问图形对象 tgraph://vertex/... 和 tgraph://query/... URI。

• UDF和算法列表
  获取已安装的用户定义函数和GDS算法目录。

项目结构

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

安装

1. 克隆仓库

   复制

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

2. 创建并激活虚拟环境

   复制

   python3 -m venv venv
   source venv/bin/activate
   

3. 安装依赖项

   复制

   pip install .
   

   需要 mcp[cli]>=1.6.0 和 pyTigerGraph>=1.8.6.

配置

运行前设置以下环境变量：

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

这些被阅读 config.py.

连接到克劳德

此MCP服务器可以安装到 克劳德桌面 客户端，以便Claude可以直接调用您的TigerGraph工具：

uv run mcp install main.py

运行上述程序后，重新启动Claude Desktop，您将通过锤子看到您的MCP工具可用🛠 偶像。

示例：

贡献

1. 分叉存储库
2. 创建要素分支
   复制

   git checkout -b feature/YourFeature
   

3. 提交您的更改
   复制

   git commit -m "Add YourFeature"
   

4. 推送到分支
   复制

   git push origin feature/YourFeature
   

5. 打开拉取请求

请确保所有新代码都包含在测试中，并遵循PEP-8风格。

许可证

该项目根据 MIT许可证.