mcpField
G
Grain SQL

Grain SQL

ローカル
grain.toolsデータベース32 日前に更新
リポジトリ公式サイト

Grain SQL について

Grain SQL は、VS Code の SQL ワークスペースで、AI エージェントから設定済みデータベースへのクエリも可能にします。エージェントはデフォルトで読み取り専用となり、実行内容は結果パネルに表示されます。

主な機能

  1. 01エディターファイルから SQL を実行
  2. 02接続プロファイルの管理とテスト
  3. 03並べ替え・フィルター可能な結果グリッド
  4. 04結果を CSV、TSV、JSON にエクスポート
  5. 05MCP 経由の読み取り専用エージェントクエリ

活用シーン

  1. 01エディターでデータベーススキーマを確認
  2. 02エージェントのクエリと結果を確認
  3. 03後続利用のためにクエリ結果全体をエクスポート

MCP 対応

Grain は MCP 経由で設定済みのデータベース接続を Claude Code、Cursor、GitHub Copilot に公開します。設定で MCP を有効にする必要があり、エージェントはデフォルトで読み取り専用、クエリは結果パネルに表示されます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "pattrnlabs-grain": {
      "command": "npx",
      "args": [
        "-y",
        "grain-tools"
      ],
      "env": {
        "GRAIN_CONNECTIONS": "<GRAIN_CONNECTIONS>",
        "GRAIN_MCP_SAFE_MODE": "<GRAIN_MCP_SAFE_MODE>",
        "GRAIN_MAX_ROWS": "<GRAIN_MAX_ROWS>"
      }
    }
  }
}
起動コマンドnpx -y grain-tools
設定が必要な環境変数
GRAIN_CONNECTIONSシークレットJSON array of Grain connection profiles for headless use.
GRAIN_MCP_SAFE_MODESet to false to allow mutating SQL. Defaults to true.
GRAIN_MAX_ROWSMaximum rows returned by query tools. Defaults to 10000.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmgrain-tools0.10.39

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Grain

VS Code 用の高速な SQL ワークスペース。利用中の AI エージェントにも対応しています。

ドキュメント · 変更履歴 · バグを報告 · 質問する

VS Code Marketplace OpenVSX

任意の .sql ファイルから Ctrl+Enter で SQL を実行し、VS Code 内の並べ替え可能なグリッドで結果を確認できます。パスワードは OS のキーチェーンに保存され、Grain にはホステッドサービスがありません。

Grain でクエリを実行

クイックスタート

  1. VS Code Marketplace または Open VSX（Cursor、Windsurf、VSCodium 用）から Grain をインストールします。
  2. VS Code でフォルダーを開きます。Grain がデモファイルを追加します。
  3. Grain パネルを開き、Try the Demo をクリックします。
  4. 開いたファイル内の任意のクエリにカーソルを置き、Ctrl+Enter（macOS では Cmd+Enter）を押します。

デモでは Grain に組み込まれた DuckDB 接続を通じて 2 つの CSV ファイルを読み込むため、セットアップは不要です。独自のデータベースにクエリを実行するには、Grain: Manage Connections を実行してプロファイルを追加し、保存する前にテストします。

Grain パネルの注釈付き画像

Grain が役に立ったら、このリポジトリにスターを付けると、ほかの開発者にも見つけてもらいやすくなります。

AI エージェントから Grain を利用する

Grain は MCP 経由で、データベース接続を Claude Code、Cursor、GitHub Copilot に提供できます。エージェントにはデフォルトで読み取り専用アクセスが許可され、エージェントが実行したクエリはすべて Grain の結果パネルに表示されるため、実行内容を正確に確認できます。

MCP は、設定で grain.mcpEnabled を有効にするまでオフになっています。各クライアントのセットアップ手順はMCP ドキュメントに、プロンプトの例は examples/agents/ にあります。

機能

機能内容
エディターから実行Ctrl+Enter でファイルを実行します。Run Query Under Cursor では 1 つのステートメントを実行し、Run Query in New Tab では前の結果を保持します
ノンブロッキングクエリクエリはバックグラウンドプロセスで実行されるため、クエリに時間がかかっても VS Code がフリーズしません
接続マネージャーJSON を編集せずにデータベースのプロファイルを作成、テスト、切り替えできます
結果グリッド列の並べ替え、フィルタリング、サイズ変更ができ、各列の SQL 型を確認したり、選択範囲を TSV としてコピーしたりできます
全件エクスポートグリッドには先頭 500 行が表示されます。エクスポートするとクエリを再実行し、すべての行を CSV、TSV、または JSON に書き出します
MCP 経由のエージェントアクセスClaude Code、Cursor、Copilot から接続にクエリを実行でき、結果はパネルに表示されます
リモート環境WSL、開発コンテナー、GitHub Codespaces、Remote - SSH で動作します

サポート対象のデータベース

リレーショナルデータベースREADME の画像
PostgreSQL		README の画像
MySQL		README の画像
SQL Server		README の画像
SQLite
データウェアハウスREADME の画像
Snowflake		README の画像
BigQuery
クエリエンジンとレイクハウスREADME の画像
Trino / Presto		README の画像
DuckDB
検索README の画像
Elasticsearch

Trino または Presto を介して、クラスターの Iceberg、Delta Lake、Hive テーブルにクエリを実行できます。 DuckDB では、ローカルの CSV ファイルや Parquet ファイルに直接クエリを実行できます。

PostgreSQL と Trino / Presto は拡張機能に同梱されています。それ以外のデータベースでは、初回使用時にドライバーが読み込まれます。ドライバーが見つからない場合は、Grain がインストールするものを案内します。

別のデータベースが必要ですか？コネクターをリクエストしてください。 👍 の多いリクエストから優先的に開発します。

使用例

Postgres、MySQL、Elasticsearch、DuckDB 用の実行可能なクエリに加え、エージェント向けプロンプトも用意しています。Grain をインストールした状態で任意の .sql ファイルを開き、Ctrl+Enter を押してください。

プライバシー

  • SQL、クエリ結果、パスワードはお使いのマシン内に留まります。 パスワードは OS のキーチェーンを利用する VS Code の Secret Storage に保存され、設定ファイルには保存されません。
  • エージェントはデフォルトで読み取り専用です。 grain.mcpSafeMode が有効（デフォルト）な場合、エージェントが実行できるのは SELECT、SHOW、DESCRIBE、EXPLAIN、WITH、およびメタデータクエリのみです。エージェントが保存済みパスワードを読み取ったり、保存済み接続を変更したりすることはできません。
  • テレメトリーは匿名です。 Grain は、SQL、クエリ結果、認証情報、ホスト名、スキーマ名を含まない使用状況データを送信します。grain.telemetry.enabled で無効にできます。

よくある質問

Grain はオープンソースですか？
いいえ。Grain はクローズドソースです。このリポジトリには、課題トラッカー、ドキュメント、使用例が含まれています。

どのデータベースに対応していますか？
上記に記載されている 9 種類です。別のデータベースを希望する場合は、コネクターをリクエストしてください。

クエリやパスワードがマシンの外部に送信されることはありますか？
いいえ。Grain サーバーはありません。クエリは VS Code からデータベースに直接送信され、パスワードは OS のキーチェーン内に保持されます。匿名テレメトリーに含まれる情報と含まれない情報については、プライバシーをご覧ください。

Claude Code または Cursor を接続するにはどうすればよいですか？
grain.mcpEnabled を有効にしてから、MCP ドキュメントでお使いのクライアント向けの手順に従ってください。

データベースにドライバーエラーが表示されるのはなぜですか？
一部のコネクターでは、初回使用時にドライバーが読み込まれます。エラーメッセージにインストールするものが記載されています。それでも解決しない場合は、Output パネルのログ（View → Output → Grain）を添えて、バグを報告してください。

ヘルプを受ける

現時点では、確定したロードマップはありません。次に何を開発するかは、ここに寄せられるリクエスト、特にコネクターのリクエストに大きく左右されます。 適切な Issue の作成方法については、CONTRIBUTING.mdをご覧ください。

スター履歴

スター履歴チャート

ライセンス

Grain はクローズドソースです。LICENSEをご覧ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。