MCP Server Snowflake

🚀 Snowflake MCP サーバー

Snowflake データベースに対して読み取り専用操作を実行するためのモデルコンテキストプロトコル（MCP）サーバーです。このツールにより、Claude は情報を一切変更することなく、安全に Snowflake データをクエリできます。

✨ 主な機能

• 柔軟な認証方式で、Snowflake への接続が可能です。
  • サービスアカウントと秘密鍵を使用した認証
  • 外部ブラウザを使用した対話型セッション認証
• 自動バックグラウンドでの接続リフレッシュ機能付きの接続プール管理により、長時間の接続を維持します。
• 以下の操作をサポートしています。
  • データのクエリ
  • データベース構造の表示
  • クエリプランの説明
  • 実行プランの解釈
  • 結果セットのサイズ制限
• 大規模なデータセットの返却を防ぐため、自動的に LIMIT 句を追加します。
• Pydantic を使用した入力検証により、SQL インジェクションを防止します。

📦 インストール

前提条件

• Python 3.12 以上
• Snowflake アカウント（読み取り専用権限が必要）

インストール手順

1. .env.example ファイルをコピーして .env という名前に変更します。
2. 環境変数を以下のように設定します。

   cp .env.example .env
   # 以下の内容を.envファイルに設定します
   SNOWFLAKE_AUTH_TYPE=private_key  # または external_browser
   SNOWFLAKE_ACCOUNT_NAME=your_account_name
   SNOWFLAKE_USER_NAME=your_user_name
   SNOWFLAKE_PRIVATE_KEY_PATH=path_to_your_private_key  # private_key 認証を使用する場合
   

3. 依存関係をインストールします。

   pip install -r requirements.txt
   

💻 使用例

サーバーの起動

python mcp_server_snowflake.py

Claude デスクトップとの統合

1. ターミナルでサーバーを起動します。
2. Claude デスクトップを開き、実行中の MCP サーバーに接続すると、対話を開始できます。

📚 ドキュメント

環境変数の設定

• SNOWFLAKE_CONN_REFRESH_HOURS：接続の自動リフレッシュ間隔を設定します（デフォルトは 24）。

  SNOWFLAKE_CONN_REFRESH_HOURS=4  # 4時間に設定
  

認証方式

秘密鍵認証

1. Snowflake でユーザーを作成し、キーペアを生成します。詳細な操作手順は Snowflake ドキュメント を参照してください。
2. 環境変数を設定します。

   SNOWFLAKE_AUTH_TYPE=private_key
   SNOWFLAKE_PRIVATE_KEY_PATH=/path/to/your/private-key.pem
   

外部ブラウザ認証

1. 環境変数を設定します。

   SNOWFLAKE_AUTH_TYPE=external_browser
   

2. サーバーを起動すると、ブラウザが自動的に開き、認証が行われます。

セキュリティに関する注意事項

• 読み取り操作（SELECT、SHOW、DESCRIBE、EXPLAIN、WITH 文）のみを許可します。
• 入力は厳密に検証され、SQL インジェクション攻撃を防止します。
• .env ファイルの安全性を確保し、機密情報の漏洩を避けてください。
• データ転送の安全を確保するため、HTTPS を使用して通信します。

開発に関する詳細

静的型チェック

mypy mcp_server_snowflake/

コードのフォーマット

ruff format .

テストの実行

pytest

🔧 技術詳細

• Snowflake Connector Python を使用してデータベースに接続します。
• MCP プロトコル に基づいて Claude とのやり取りを実現します。
• Pydantic を使用してデータ検証を行います。
• python-dotenv を使用して環境変数を管理します。