Mcp Snowflake Server Nsp

• • • •

Test
Lint
Meta
Security
Best Practices
Documentation

Snowflake MCP 服务 NSP

一个 模型上下文协议（MCP） 服务 / MCP 服务，可将 AI 助手连接到 Snowflake — 让你可以直接通过大模型客户端运行 SQL 查询、探索架构并获取数据洞察。

亮点：

• 多种身份验证方式：密码、密钥对、外部浏览器、OAuth 2.0（客户端凭据和 Bearer 令牌）、TOML 连接文件
• TOML 多连接配置 — 在一个文件中管理 production、staging 和 development 环境
• 写入安全防护 — 默认禁用写入操作，必须显式启用
• 排除模式 — 从发现结果中过滤数据库、架构或表
• --exclude-json-results 标志 — 减少大模型上下文窗口的使用
• 使用 --exclude_tools 选择性排除工具
• 预取模式 — 将表架构预加载为 MCP 资源
• 支持 Docker，并提供经过强化的映像（DHI、非 root 用户、运行时不含 shell）

目录

• Snowflake MCP 服务 NSP
  • 目录
  • 快速开始
    • Claude Code
    • Visual Studio Code（VSCode）
    • OpenCode
  • 组件
    • 资源
    • 工具
      • 查询工具
      • 架构工具
      • 分析工具
  • 身份验证
    • 密码
    • 密钥对
    • 外部浏览器
    • OAuth 2.0 客户端凭据
    • OAuth Bearer 令牌
    • TOML 连接文件（推荐）
  • 安装
    • 通过 UVX
    • 通过 Docker Hub
  • 配置参考
  • 排除模式
  • 许可证
  • Fork 和归属说明

快速开始

最快的试用方式 — 使用 uvx 和 TOML 连接文件：

# 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 Bearer 令牌

使用预先获取的 OAuth Bearer 令牌：

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

TOML 连接文件（推荐）

在单个文件中管理多个环境。完整模板请参见 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。

参与贡献或从源代码运行？ 请参见 CONTRIBUTING.md，了解本地开发环境设置、测试命令、代码格式化，以及如何从源代码构建 Docker 镜像。

通过 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

注意： -i（--interactive）是保持 stdin 打开以供 MCP stdio 传输使用所必需的。不要使用 -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 中。