Snowflake MCP Server

🚀 雪地花 MCP（モデルコンテキストプロトコル）サーバー

このサーバーは、Model Context Protocol (MCP) を実装しており、Claude のような AI アシスタントが自然言語で Snowflake データベースと対話できるようにします。

✨ 主な機能

• 自然言語で Snowflake データベースの SQL クエリを実行します。
• データベース接続のライフサイクル（接続、再接続、切断）を自動的に管理します。
• Claude、Cursor IDE などの MCP 互換クライアントと統合します。
• セマンティック理解を使用して、自然言語を SQL に変換します。
• クエリ結果を処理し、読みやすい形式で表示します。
• 適切な認証を使用して、安全なデータベース操作を行います。

📦 インストール

前提条件

• Python 3.8 以上
• 適切なアクセス権限を持つ Snowflake アカウント
• MCP 互換クライアント（Claude、Cursor IDE など）

インストール手順

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/snowflake-mcp.git
cd snowflake-mcp

2. 必要な依存関係をインストールします：

pip install -r requirements.txt

3. サンプル環境ファイルをコピーし、Snowflake の資格情報を追加します：

cp .env.sample .env
# .env ファイルで Snowflake の資格情報を編集します

📚 ドキュメント

環境変数

Snowflake の資格情報を含む .env ファイルを作成します：

SNOWFLAKE_USER=your_username
SNOWFLAKE_PASSWORD=your_password
SNOWFLAKE_ACCOUNT=your_account_locator  # 例: xy12345.us-east-2
SNOWFLAKE_DATABASE=your_database
SNOWFLAKE_WAREHOUSE=your_warehouse
SNOWFLAKE_SCHEMA=your_schema  # オプション、デフォルトは PUBLIC
SNOWFLAKE_ROLE=your_role  # オプション、デフォルトはデフォルトのロール

MCP クライアントの設定

Cursor IDE の場合

Cursor は自動的に MCP サーバーを検出して統合します。サーバーが実行中であることを確認するだけです。

Claude Desktop の場合

claude_desktop_config.json ファイルに以下の内容を追加します：

{
  "mcpServers": {
    "snowflake": {
      "command": "/path/to/python",
      "args": ["/path/to/snowflake-mcp/src/server.py"]
    }
  }
}

/path/to/python をインストールした Python インタープリターのパスに置き換え、/path/to/snowflake-mcp をこのリポジトリをクローンした完全なパスに置き換えます。

💻 使用例

基本的な使用法

雪地花 MCP サーバーは、Model Context Protocol (MCP) 仕様を実装しており、Claude などの AI システムが自然言語で Snowflake データベースに接続できるようにします。

高度な使用法

MCP CLI を使用する（推奨）

MCP Python SDK には、MCP サーバーを簡単に実行および管理するためのコマンドラインインターフェイスが含まれています。

1. 開発モードとインスペクター UI：

mcp dev src/server.py

このコマンドはサーバーを起動し、ブラウザでインスペクター UI を開きます。ここでツールをテストできます。

2. Claude Desktop へのインストール：

mcp install src/server.py

このコマンドはサーバーを Claude Desktop にインストールし、Claude から使用できるようにします。

3. 標準モード：

mcp run src/server.py

このコマンドは、MCP サーバーを標準モードで実行します。デフォルトではアドレス 0.0.0.0 とポート 9123 でバインドされます。

📄 ライセンス

MIT License

謝辞

• Model Context Protocol を作成したチーム
• 強力なデータベースと API を提供する Snowflake