MCP Snowflake Server

🚀 雪花 MCP 服務器

雪花 MCP 服務器是一個模型上下文協議（MCP）服務器實現，可與 Snowflake 數據庫進行交互。通過該服務器，你能借助工具運行 SQL 查詢，還能將數據見解和模式上下文作為資源公開，為數據處理和分析提供便利。

🚀 快速開始

在使用雪花 MCP 服務器前，你需要完成安裝和配置。具體步驟如下：

1. 安裝服務器，可通過 Smithery 或 UVX 進行安裝。
2. 配置環境變量，確保服務器能正常連接 Snowflake 數據庫。
3. 啟動服務器。
4. 在 Claude Desktop 中進行配置，以便使用該服務器。

✨ 主要特性

• 資源豐富：提供 memo://insights 持續更新數據見解，以及 context://table/{table_name} 公開表信息（需啟用預取）。
• 操作靈活：默認禁用寫入操作，可通過 --allow-write 顯式啟用；支持通過排除模式過濾特定數據庫、模式或表。
• 動態更新：append_insight 工具可動態更新 memo://insights 資源。

📦 安裝指南

通過 Smithery 安裝

訪問 smithery.ai 下載並安裝 MCP 雪花服務器。

使用 UVX 安裝

步驟如下：

1. 克隆倉庫：

git clone https://github.com/your-username/mcp-snowflake-server.git
cd mcp-snowflake-server

2. 創建並激活虛擬環境（可選但推薦）：

python -m venv venv
source venv/bin/activate  # 在 Unix/MacOS 中
# 或者
.\venv\Scripts\activate  # 在 Windows 中

3. 安裝依賴項：

pip install -r requirements.txt

4. 運行服務器：

python run.py

💻 使用示例

配置環境變量

在運行服務器之前，確保設置以下環境變量：

SNOWFLAKE_ACCOUNT
SNOWFLAKE_USER
SNOWFLAKE_PASSWORD
SNOWFLAKE_DATABASE
SNOWFLAKE_SCHEMA
SNOWFLAKE_WAREHOUSE

啟動服務器

運行以下命令啟動 MCP 雪花服務器：

uv --directory /absolute/path/to/mcp_snowflake_server run mcp_snowflake_server

在 Claude Desktop 中配置

在 claude_desktop_config.json 文件中添加以下內容：

"mcpServers": {
  "snowflake_local": {
    "command": "/absolute/path/to/uv",
    "args": [
      "--python=3.12",  // 可選參數
      "--directory", "/absolute/path/to/mcp_snowflake_server",
      "run", "mcp_snowflake_server"
      // 其他可選參數：
      // --allow-write
      // --log_dir, /absolute/path/to/logs
      // --log_level, DEBUG/INFO/WARNING/ERROR/CITICAL
    ]
  }
}

📚 詳細文檔

組件 - 資源

• memo://insights：一個持續更新的備忘錄，彙總已發現的數據見解。當新的見解通過 append_insight 工具添加時，會自動更新。
• context://table/{table_name}：（如果啟用了預取）每個表的上下文資源，公開有關表的信息。

⚠️ 注意事項

⚠️ 重要提示

• 默認情況下，寫入操作被禁用。請通過 --allow-write 顯式啟用。
• 服務器支持通過排除模式過濾特定數據庫、模式或表。
• 如果啟用了預取功能，服務器會公開額外的每個表上下文資源。
• append_insight 工具會動態更新 memo://insights 資源。

📄 許可證

本項目採用 MIT 許可證。