Christian561 Gel MCP Server

🚀 Gel 数据库 MCP 服务器

Gel 数据库 MCP 服务器是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器，它借助 EdgeQL 查询简化了 Gel 数据库操作。该项目为 LLM 代理（如 Cursor Agent、Claude Code 等）提供工具，使其能自动学习数据库架构，编写、验证和执行查询，让用户可以通过自然语言轻松与 Gel 数据库交互。代码开发者的福音！

⚠️ 重要提示

查询生成不在此项目范围内，因为 LLM 可以编写更灵活的查询。使用 Cursor 代理（带有 Claude - 3.7 - sonnet - thinking）并提供 Gel 文档后能取得良好效果。

🚀 快速开始

安装与初始化

# 1. 安装依赖项
yarn install

# 2. 如果您已经有 dbschema 文件夹，请将其复制到项目中
# cp -r /path/to/your/dbschema ./
# 或直接复制粘贴

# 3. 初始化 Gel 项目
npx gel project init
# 按照提示设置新项目
# 可以通过提供实例名称指向现有 Gel 实例
#   - 如果需要，导入迁移

# 4. 生成 EdgeQL JavaScript 查询构建器文件
npx @gel/generate edgeql-js
# 注意：在任何架构更改后重新运行此命令

# 5. 更新连接设置
# 编辑 src/index.ts 中的代理部分
# 安装依赖项：
# npm install @gel/core @gel/typescript gel-language-server --save-dev
# 配置 tsconfig.json 和 jsconfig.json

# 6. 运行服务器
npm run dev

# 7. 使用代理进行查询
curl http://localhost:3000/api/execute

✨ 主要特性

执行 TypeScript

• 类似于 execute - edgeql，但用于测试和运行用查询构建器语法编写的 TypeScript Gel 查询。
• 指令包含在工具中，但仍建议代理加载这些指令以确保它们不会被跳过。
• 注意：JavaScript 语法错误可能会导致服务器崩溃，因此如果连接显示为已关闭，请刷新 Cursor MCP 设置中的代理或重新启动服务器。

💡 使用建议

• 使用 await gelClient.query() 并用 console.log 显示结果
• 使用 ORDER BY 带有 THEN 而不是逗号（例如，ORDER BY .field1 THEN .field2）
• 保持代码简单并专注于单一操作

基础用法

console.log(await gelClient.query(`
  SELECT Product { 
    name, 
    price 
  } 
  FILTER .price > 100 
  ORDER BY .price DESC 
  LIMIT 5;
`));

📚 详细文档

有关 Model Context Protocol 的更多信息，请访问 modelcontextprotocol.io/quickstart。