Christian561 Gel MCP Server

🚀 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 を参照してください。