🚀 雪地花 MCP（模型上下文协议）服务器
雪地花 MCP 服务器实现了 Model Context Protocol (MCP)，能让像 Claude 这样的 AI 助手通过自然语言与 Snowflake 数据库进行交互，极大提升了数据库操作的便捷性。
✨ 主要特性
- 自然语言查询：可通过自然语言直接执行 Snowflake 数据库的 SQL 查询。
- 连接自动管理：自动管理数据库连接的生命周期，包括连接、重新连接和关闭操作。
- 多客户端集成：能与 Claude、Cursor IDE 以及其他兼容 MCP 的客户端集成。
- 语义转换：利用语义理解能力将自然语言转换为 SQL 语句。
- 结果处理：处理查询结果，并以易于阅读的格式呈现。
- 安全操作：使用适当的身份验证机制，确保数据库操作的安全性。
📦 安装指南
先决条件
- Python 3.8 及以上版本。
- 具备适当访问权限的 Snowflake 账户。
- MCP 兼容客户端（如 Claude、Cursor IDE 等）。
安装步骤
- 克隆此仓库：
git clone https://github.com/yourusername/snowflake-mcp.git
cd snowflake-mcp
- 安装所需的依赖项：
pip install -r requirements.txt
- 复制示例环境文件并添加您的 Snowflake 凭据：
cp .env.sample .env
# 在 .env 文件中编辑您的 Snowflake 凭据
📚 详细文档
配置
环境变量
创建一个包含您 Snowflake 凭据的 .env 文件：
SNOWFLAKE_USER=your_username
SNOWFLAKE_PASSWORD=your_password
SNOWFLAKE_ACCOUNT=your_account_locator # 例如 xy12345.us-east-2
SNOWFLAKE_DATABASE=your_database
SNOWFLAKE_WAREHOUSE=your_warehouse
SNOWFLAKE_SCHEMA=your_schema # 可选，默认为 PUBLIC
SNOWFLAKE_ROLE=your_role # 可选，默认为您默认的角色
MCP 客户端配置
对于 Cursor IDE
Cursor 会自动发现并集成与 MCP 服务器，您只需确保服务器正在运行即可。
对于 Claude Desktop
在 claude_desktop_config.json 文件中添加以下内容：
{
"mcpServers": {
"snowflake": {
"command": "/path/to/python",
"args": ["/path/to/snowflake-mcp/src/server.py"]
}
}
}
请将 /path/to/python 替换为您安装的 Python 解释器路径，将 /path/to/snowflake-mcp 替换为克隆此仓库的完整路径。
💻 使用示例
雪地花 MCP 服务器实现了 Model Context Protocol (MCP) 规范，允许 AI 系统如 Claude 通过自然语言连接到 Snowflake 数据库。
基础用法
MCP Python SDK 包含一个命令行界面，用于轻松运行和管理 MCP 服务器。
开发模式与 Inspector UI
mcp dev src/server.py
此命令启动服务器并在您的浏览器中打开 inspector 界面，您可以在其中测试工具。
在 Claude Desktop 中安装
mcp install src/server.py
此命令将服务器安装到 Claude Desktop，使其可供 Claude 使用。
标准模式
mcp run src/server.py
此命令以标准方式运行 MCP 服务器，默认绑定地址 0.0.0.0 和端口 9123。
📄 许可证
本项目采用 MIT License 许可协议。
致谢
- 感谢创建 Model Context Protocol 的团队。
- 感谢 Snowflake 提供强大的数据库和 API。