snowflake-mcp-server

🚀 Snowflake MCP 服务器

Snowflake MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，可对 Snowflake 数据库执行只读操作。它让 Claude 能够安全查询 Snowflake 数据，且不会对数据进行任何修改。

🚀 快速开始

在使用 Snowflake MCP 服务器前，你需要完成环境变量配置，并运行服务器。具体步骤如下：

1. 在项目根目录创建一个 .env 文件，并添加以下内容：

SNOWFLAKE_AUTH_TYPE=private_key 或 external_browser
SNOWFLAKE_PRIVATE_KEY_PATH=私钥路径（如使用 private_key 身份验证）
SNOWFLAKE_ACCOUNT_NAME=账户名称

2. 运行服务器：

python mcp_server_snowflake/main.py

✨ 主要特性

• 灵活的身份验证：可通过服务账户和私有密钥进行身份验证，也能使用外部浏览器进行交互式会话身份验证，从而方便地连接到 Snowflake。
• 连接池自动刷新：带有自动背景刷新的连接池，能保持持久连接，确保服务的稳定性。
• 多视图和数据库查询：支持在单个会话中查询多个视图和数据库，满足多样化的数据查询需求。
• 多类型 SQL 语句支持：支持多种 SQL 语句类型，包括 SELECT、SHOW、DESCRIBE、EXPLAIN、WITH。
• MCP 兼容处理器：具备 MCP 兼容的处理器，可用于查询 Snowflake 数据。
• 只读操作与安全检查：仅支持只读操作，并带有安全检查，有效防止数据被修改。
• Python 版本适配：支持 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

📚 详细文档

功能模块

• mcp_server_snowflake.mcp_server：MCP 服务器主逻辑。
• mcp_server_snowflake.models：数据模型和验证。
• mcp_server_snowflake.auth：身份验证处理。
• mcp_server_snowflake.utils：工具函数和配置管理。

安全注意事项

• 所有查询都会自动添加 LIMIT 子句，以防止处理大数据集带来的风险。
• 禁止执行任何写入操作，如 INSERT、UPDATE、DELETE。
• 输入验证严格过滤 SQL 注入风险。
• 私钥和凭据不会持久化到磁盘。
• 使用 HTTPS 进行与 Snowflake 的通信。

开发信息

代码检查工具

# 静态类型检查
mypy mcp_server_snowflake/

# 代码格式检查
ruff check .

# 代码自动格式化
ruff format .

# 单元测试
pytest

贡献指南

欢迎贡献！请随意提交 Pull Request。

🔧 技术细节

• 使用 Snowflake Python 连接器 实现与 Snowflake 的连接。
• 基于 MCP 协议 与 Claude 进行交互。
• 使用 Pydantic 进行数据验证。
• 使用 python-dotenv 管理环境变量。