Snowflake MCP Server

🚀 雪地花 MCP（模型上下文協議）服務器

雪地花 MCP 服務器實現了 Model Context Protocol (MCP)，能讓像 Claude 這樣的 AI 助手通過自然語言與 Snowflake 數據庫進行交互，極大提升了數據庫操作的便捷性。

✨ 主要特性

• 自然語言查詢：可通過自然語言直接執行 Snowflake 數據庫的 SQL 查詢。
• 連接自動管理：自動管理數據庫連接的生命週期，包括連接、重新連接和關閉操作。
• 多客戶端集成：能與 Claude、Cursor IDE 以及其他兼容 MCP 的客戶端集成。
• 語義轉換：利用語義理解能力將自然語言轉換為 SQL 語句。
• 結果處理：處理查詢結果，並以易於閱讀的格式呈現。
• 安全操作：使用適當的身份驗證機制，確保數據庫操作的安全性。

📦 安裝指南

先決條件

• Python 3.8 及以上版本。
• 具備適當訪問權限的 Snowflake 賬戶。
• MCP 兼容客戶端（如 Claude、Cursor IDE 等）。

安裝步驟

1. 克隆此倉庫：

git clone https://github.com/yourusername/snowflake-mcp.git
cd snowflake-mcp

2. 安裝所需的依賴項：

pip install -r requirements.txt

3. 複製示例環境文件並添加您的 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。