Snowflake MCP Server

🚀 Snowflake MCP サーバー

Snowflake データベースに対して読み取り専用操作を実行するための Model Context Protocol (MCP) サーバーです。このツールにより、Claude は情報を変更することなく安全に Snowflake データを照会できます。

✨ 主な機能

• 柔軟な認証機能で、以下の方法で Snowflake に接続できます。
  • サービスアカウントと秘密鍵を使用した認証
  • 外部ブラウザを使用した対話型セッション認証
• 自動バックグラウンドリフレッシュ機能付きの接続プールで、持続的な接続を維持します。
• 単一会話で複数のビューとデータベースを照会できます。
• 複数の SQL ステートメントタイプ（SELECT、SHOW、DESCRIBE、EXPLAIN、WITH）をサポートします。
• Snowflake データを照会するための MCP 互換プロセッサが搭載されています。
• 読み取り専用操作で、データの変更を防止するためのセキュリティチェックがあります。
• Python 3.12 以上をサポートします。
• 標準入出力 (stdio) ベースの MCP サーバーで、Claude Desktop との統合が容易です。

📦 インストール

インストール要件

python-dotenv
mypy
ruff
pytest
pydantic
snowflake-connector-python

インストール手順

pip install python-dotenv mypy ruff pytest pydantic snowflake-connector-python

💻 使用例

基本的な使用法

環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

SNOWFLAKE_AUTH_TYPE=private_key または external_browser
SNOWFLAKE_PRIVATE_KEY_PATH=秘密鍵のパス（private_key 認証を使用する場合）
SNOWFLAKE_ACCOUNT_NAME=アカウント名

サーバーの起動

python mcp_server_snowflake/main.py

高度な使用法

本サーバーは、柔軟な認証や複数の SQL ステートメントタイプのサポートなど、多くの高度な機能を備えています。上記の基本的な使用法に従って環境を設定した後、これらの機能を活用することができます。

🔧 機能モジュール

• mcp_server_snowflake.mcp_server: MCP サーバーの主なロジック
• mcp_server_snowflake.models: データモデルと検証
• mcp_server_snowflake.auth: 認証処理
• mcp_server_snowflake.utils: ユーティリティ関数と設定管理

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

• すべてのクエリには自動的に LIMIT 句が追加され、大規模なデータセットのリスクを防止します。
• 書き込み操作（INSERT、UPDATE、DELETE など）の実行は禁止されています。
• 入力検証により、SQL インジェクションのリスクが厳格にフィルタリングされます。
• 秘密鍵と資格情報はディスクに永続化されません。
• Snowflake との通信には HTTPS が使用されます。

📚 開発情報

コードチェックツール

# 静的型チェック
mypy mcp_server_snowflake/

# コードフォーマットチェック
ruff check .

# コード自動フォーマット
ruff format .

# 単体テスト
pytest

コントリビューションガイド

コントリビューションを歓迎します！自由に Pull Request を送信してください。

🔧 技術詳細

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