TG_MCP

一个轻量级的Python接口，将TigerGraph操作（查询、模式、顶点、边、用户定义函数）作为结构化工具和基于URI的资源提供给MCP代理。

目录

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

特性

• 模式内省
  获取完整的图模式（顶点类型和边类型）。

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

• 顶点与边的插入更新
  程序化地创建或更新顶点和边。

• 资源URI
  通过tgraph://vertex/...和tgraph://query/...URI访问图对象。

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

项目结构

TG_MCP/
├── config.py            # 环境配置（HOST, GRAPH, SECRET）
├── tg_client.py         # 封装TigerGraphConnection和核心操作
├── tg_tools.py          # 使用`@mcp.tool`定义暴露客户端方法
├── tg_resources.py      # 使用`@mcp.resource`处理URI
├── main.py              # MCP应用启动（`mcp.run()`）
├── pyproject.toml       # 项目元数据及依赖项
├── LICENSE              # MIT许可证
└── .gitignore           # 操作系统/Python忽略规则

安装

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://<您的-tigergraph主机>
export TG_GRAPH=<您的图名称>
export TG_SECRET=<您的API密钥>

这些变量由config.py读取。

连接到Claude

此MCP服务器可以安装到Claude Desktop客户端中，以便Claude可以直接调用您的TigerGraph工具：

uv run mcp install main.py

运行上述命令后，重启Claude Desktop，您将看到您的MCP工具可通过锤子图标（🛠）访问。

示例：

贡献

1. 分叉仓库
2. 创建功能分支

   git checkout -b feature/您的功能
   

3. 提交更改

   git commit -m "添加您的功能"
   

4. 推送到分支

   git push origin feature/您的功能
   

5. 打开拉取请求

请确保所有新代码都经过测试，并遵循PEP-8风格。

许可证

本项目采用MIT许可证。