Mcp Snowflake Server Nsp

• • • •

Test
Lint
Meta
Security
Best Practices
Documentation

Snowflake MCP Server NSP

Model Context Protocol (MCP) サーバー／MCP サーバーです。AI アシスタントを Snowflake に接続し、LLM クライアントから SQL クエリ、スキーマの探索、データの分析情報の取得を直接行えるようにします。

主な特長：

• 複数の認証方式に対応：パスワード、キー ペア、外部ブラウザー、OAuth 2.0（クライアント認証情報とベアラートークン）、TOML 接続ファイル
• TOML による複数接続の設定 — 1 つのファイルで production、staging、development 環境を管理できます
• 書き込み安全ガード — 書き込み操作はデフォルトで無効になっており、明示的に有効にする必要があります
• 除外パターン — 検出対象からデータベース、スキーマ、テーブルを除外できます
• --exclude-json-results フラグ — LLM のコンテキストウィンドウの使用量を削減します
• --exclude_tools によるツールの選択的な除外
• プリフェッチモード — テーブルスキーマを MCP リソースとして事前に読み込みます
• 強化されたイメージを使用する Docker サポート（DHI、root 以外のユーザー、実行時のシェルなし）

目次

• Snowflake MCP Server NSP
  • 目次
  • クイックスタート
    • Claude Code
    • Visual Studio Code（VSCode）
    • OpenCode
  • コンポーネント
    • リソース
    • ツール
      • クエリツール
      • スキーマツール
      • 分析ツール
  • 認証
    • パスワード
    • キー ペア
    • 外部ブラウザー
    • OAuth 2.0 クライアント認証情報
    • OAuth ベアラートークン
    • TOML 接続ファイル（推奨）
  • インストール
    • UVX 経由
    • Docker Hub 経由
  • 設定リファレンス
  • 除外パターン
  • ライセンス
  • フォークと帰属表示

クイックスタート

最も手早く試すには、TOML 接続ファイルと uvx を使用します。

# 1. Create a connections file
cat > ~/snowflake_connections.toml << 'EOF'
[myconn]
account = "your_account"
user = "your_user"
password = "your_password"
warehouse = "COMPUTE_WH"
database = "MY_DB"
schema = "PUBLIC"
role = "MYROLE"
EOF

# 2. Run the server
uvx --python=3.13 --from mcp-snowflake-server-nsp mcp_snowflake_server \
  --connections-file ~/snowflake_connections.toml \
  --connection-name myconn

Claude Code

snowflake_connections.toml を使用して、MCP クライアントの設定（例：claude_desktop_config.json）に追加します。

"mcpServers": {
  "snowflake": {
    "command": "uvx",
    "args": [
      "--python=3.13",
      "--from", "mcp-snowflake-server-nsp",
      "mcp_snowflake_server",
      "--connections-file", "/absolute/path/to/snowflake_connections.toml",
      "--connection-name", "myconn"
    ]
  }
}

Visual Studio Code（VSCode）

uvx —

Docker —

または、.env ファイルを使用して（認証を参照）、MCP クライアントの設定（例：.vscode/mcp.json）に手動で追加します。

"snowflake": {
      // Snowflake MCP server
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from", "mcp-snowflake-server-nsp",
        "--python=3.13",
        "mcp_snowflake_server"
      ],
      "envFile": "${workspaceFolder}/.env"
    }

OpenCode

.env ファイルを使用して（認証を参照）、MCP クライアントの設定（例：opencode.jsonc）に追加します。

"snowflake": {
  "type": "local",
  "command": [
    "uvx",
    "--from",
    "mcp-snowflake-server-nsp",
    "--python=3.13",
    "mcp_snowflake_server",
  ],
  "enabled": true,
  "timeout": 300000,
}

コンポーネント

リソース

ツール

クエリツール

スキーマツール

分析ツール

認証

パスワード

環境変数または CLI フラグで認証情報を設定します（設定リファレンスを参照）：

SNOWFLAKE_USER="[email protected]"
SNOWFLAKE_ACCOUNT="myaccount"
SNOWFLAKE_AUTHENTICATOR="snowflake"
SNOWFLAKE_PASSWORD="secret"
SNOWFLAKE_WAREHOUSE="COMPUTE_WH"
SNOWFLAKE_DATABASE="MY_DB"
SNOWFLAKE_SCHEMA="PUBLIC"
SNOWFLAKE_ROLE="MYROLE"

キーペア

RSA（RS256）と ECDSA（ES256、ES384、ES512）の秘密鍵がサポートされています（ECDSA には snowflake-connector-python ≥ 4.5.0 が必要です）。

SNOWFLAKE_USER="[email protected]"
SNOWFLAKE_ACCOUNT="myaccount"
SNOWFLAKE_AUTHENTICATOR="snowflake_jwt"
SNOWFLAKE_PRIVATE_KEY_FILE="/absolute/path/to/key.p8"
SNOWFLAKE_PRIVATE_KEY_FILE_PWD="passphrase"  # Optional — only if key is encrypted
SNOWFLAKE_WAREHOUSE="COMPUTE_WH"
SNOWFLAKE_DATABASE="MY_DB"
SNOWFLAKE_SCHEMA="PUBLIC"
SNOWFLAKE_ROLE="MYROLE"

または CLI で指定します：--private_key_file /path/to/key.p8 --private_key_file_pwd passphrase

外部ブラウザー

SNOWFLAKE_AUTHENTICATOR="externalbrowser"

または TOML 接続エントリで指定します：authenticator = "externalbrowser"

OAuth 2.0 クライアントクレデンシャル

OAuth 2.0 クライアントクレデンシャルフローを使用して、クライアント ID とシークレットで認証します（ユーザーによる操作は不要です）：

SNOWFLAKE_AUTHENTICATOR="oauth_client_credentials"
SNOWFLAKE_ACCOUNT="myaccount"
SNOWFLAKE_OAUTH_CLIENT_ID="your_client_id"
SNOWFLAKE_OAUTH_CLIENT_SECRET="your_client_secret"
SNOWFLAKE_OAUTH_TOKEN_REQUEST_URL="https://your-idp.example.com/oauth/token"
SNOWFLAKE_OAUTH_SCOPE="session:role:MY_ROLE"  # Optional
SNOWFLAKE_WAREHOUSE="COMPUTE_WH"
SNOWFLAKE_DATABASE="MY_DB"
SNOWFLAKE_SCHEMA="PUBLIC"
SNOWFLAKE_ROLE="MYROLE"

OAuth ベアラートークン

事前に取得した OAuth ベアラートークンを使用します：

SNOWFLAKE_AUTHENTICATOR="oauth"
SNOWFLAKE_ACCOUNT="myaccount"
SNOWFLAKE_TOKEN="eyJhbGciOiJSUzI1NiJ9..."
SNOWFLAKE_WAREHOUSE="COMPUTE_WH"
SNOWFLAKE_DATABASE="MY_DB"
SNOWFLAKE_SCHEMA="PUBLIC"
SNOWFLAKE_ROLE="MYROLE"

TOML 接続ファイル（推奨）

複数の環境を 1 つのファイルで管理できます。完全なテンプレートについては、example_connections.tomlを参照してください。

[production]
account = "your_account"
user = "your_user"
password = "your_password"
authenticator = "snowflake"
warehouse = "COMPUTE_WH"
database = "PROD_DB"
schema = "PUBLIC"
role = "ACCOUNTADMIN"

[development]
account = "your_account"
user = "dev_user"
authenticator = "externalbrowser"
warehouse = "DEV_WH"
database = "DEV_DB"
schema = "PUBLIC"
role = "DEVELOPER"

[reporting]
account = "your_account"
user = "reporting_user"
authenticator = "snowflake_jwt"
private_key_file = "/path/to/private_key.pem"
private_key_file_pwd = "passphrase"  # Optional
warehouse = "REPORTING_WH"
database = "REPORTING_DB"
schema = "REPORTS"
role = "REPORTING_ROLE"

[analytics_oauth]
account = "your_account"
authenticator = "oauth_client_credentials"
oauth_client_id = "your_client_id"
oauth_client_secret = "your_client_secret"
oauth_token_request_url = "https://your-idp.example.com/oauth/token"
oauth_scope = "session:role:ANALYTICS_ROLE"  # Optional
warehouse = "ANALYTICS_WH"
database = "ANALYTICS_DB"
schema = "PUBLIC"
role = "ANALYTICS_ROLE"

--connections-file でファイルを指定し、--connection-name でプロファイルを選択します。両方のフラグをセットで指定する必要があります。

インストール

パッケージは PyPI で mcp-snowflake-server-nsp として公開されています。

コントリビュートまたはソースからの実行をお考えですか？ ローカル開発環境のセットアップ、テストコマンド、フォーマット、ソースからの Docker イメージのビルドについては、CONTRIBUTING.mdを参照してください。

UVX を使用する場合

"mcpServers": {
  "snowflake_production": {
    "command": "uvx",
    "args": [
      "--python=3.13",
      "--from", "mcp-snowflake-server-nsp",
      "mcp_snowflake_server",
      "--connections-file", "/path/to/snowflake_connections.toml",
      "--connection-name", "production"
      // Optional flags — see Configuration Reference
    ]
  },
  "snowflake_staging": {
    "command": "uvx",
    "args": [
      "--python=3.13",
      "--from", "mcp-snowflake-server-nsp",
      "mcp_snowflake_server",
      "--connections-file", "/path/to/snowflake_connections.toml",
      "--connection-name", "staging"
    ]
  }
}

"mcpServers": {
  "snowflake": {
    "command": "uvx",
    "args": [
      "--python=3.13",
      "--from", "mcp-snowflake-server-nsp",
      "mcp_snowflake_server",
      "--account", "your_account",
      "--warehouse", "your_warehouse",
      "--user", "your_user",
      "--password", "your_password",
      "--role", "your_role",
      "--database", "your_database",
      "--schema", "your_schema"
      // Optional: "--private_key_file", "/absolute/path/key.p8"
      // Optional: "--private_key_file_pwd", "passphrase"
      // Optional flags — see Configuration Reference
    ]
  }
}

Docker Hub を使用する場合

イメージは Docker Hub で公開されているため、ビルド手順は不要です：

docker pull nsphung/mcp-snowflake-server-nsp

注： MCP stdio トランスポート用に stdin を開いたままにするには、-i（--interactive）が必要です。-d（デタッチ）は使用しないでください。

"mcpServers": {
  "snowflake": {
    "command": "docker",
    "args": [
      "run", "--rm", "-i",
      "--env-file", "/absolute/path/to/.env",
      "nsphung/mcp-snowflake-server-nsp"
    ]
  }
}

"mcpServers": {
  "snowflake": {
    "command": "docker",
    "args": [
      "run", "--rm", "-i",
      "-v", "/path/to/snowflake_connections.toml:/app/snowflake_connections.toml:ro",
      "nsphung/mcp-snowflake-server-nsp",
      "--connections-file", "/app/snowflake_connections.toml",
      "--connection-name", "production"
    ]
  }
}

"snowflake": {
  "type": "stdio",
  "command": "docker",
  "args": [
    "run", "--rm", "-i",
    "nsphung/mcp-snowflake-server-nsp"
  ],
  "envFile": "${workspaceFolder}/.env"
}

"snowflake": {
  "type": "stdio",
  "command": "docker",
  "args": [
    "run", "--rm", "-i",
    "-v", "/path/to/snowflake_connections.toml:/app/snowflake_connections.toml:ro",
    "nsphung/mcp-snowflake-server-nsp",
    "--connections-file", "/app/snowflake_connections.toml",
    "--connection-name", "production"
  ]
}

"snowflake": {
  "type": "local",
  "command": [
    "docker", "run", "--rm", "-i",
    "--env-file", "/absolute/path/to/.env",
    "nsphung/mcp-snowflake-server-nsp"
  ],
  "enabled": true,
  "timeout": 300000
}

設定リファレンス

すべての接続パラメーターは、環境変数（SNOWFLAKE_<PARAM_UPPER>）としても設定できます。

除外パターン

runtime_config.json を編集して、すべての検出ツールからデータベース、スキーマ、またはテーブルを除外します。パターンは大文字と小文字を区別せず、部分文字列として照合されます。

{
  "exclude_patterns": {
    "databases": ["temp"],
    "schemas": ["temp", "information_schema"],
    "tables": ["temp"]
  }
}

サーバーは起動時に、作業ディレクトリからこのファイルを自動的に読み込みます。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。全文については LICENSE ファイルを参照してください。

フォークと帰属表示

このリポジトリは isaacwasserman/mcp-snowflake-server のフォークです。

• 上流の作者および貢献者は、それぞれの貢献に関する著作権を保持します。
• フォーク固有の変更は nsphung が管理しています。
• 主な変更点の概要は NOTICE で確認できます。