Snowflake MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器实现，提供与 Snowflake 的数据库交互。 该服务器支持使用工具运行 SQL 查询，并与表示为资源的数据洞察备忘录进行交互。

组件

资源

服务器公开一个动态资源：

• memo://insights: 一个持续更新的数据洞察备忘录，聚合分析过程中发现的洞察
  • 通过 append-insight 工具发现新洞察时自动更新

工具

服务器提供六个核心工具：

查询工具

• read_query

  • 执行 SELECT 查询以从数据库读取数据
  • 输入：
    • query (string): 要执行的 SELECT SQL 查询
  • 返回：查询结果作为对象数组

• write_query (使用 --allow-write 标志)

  • 执行 INSERT、UPDATE 或 DELETE 查询
  • 输入：
    • query (string): SQL 修改查询
  • 返回：{ affected_rows: number }

• create_table (使用 --allow-write 标志)

  • 在数据库中创建新表
  • 输入：
    • query (string): CREATE TABLE SQL 语句
  • 返回：表创建确认

模式工具

• list_tables

  • 获取数据库中所有表的列表
  • 无需输入
  • 返回：表名数组

• describe-table

  • 查看特定表的列信息
  • 输入：
    • table_name (string): 要描述的表的名称（可以是完全限定的）
  • 返回：包含名称和类型的列定义数组

分析工具

• append_insight
  • 将新的数据洞察添加到备忘录资源
  • 输入：
    • insight (string): 从分析中发现的数据洞察
  • 返回：洞察添加确认
  • 触发 memo://insights 资源的更新

与 Claude Desktop 一起使用

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Snowflake Server：

npx -y @smithery/cli install mcp_snowflake_server --client claude

通过 UVX 安装

# 将服务器添加到您的 claude_desktop_config.json
"mcpServers": {
  "snowflake_pip": {
      "command": "uvx",
      "args": [
          "mcp_snowflake_server",
          "--account",
          "the_account",
          "--warehouse",
          "the_warehouse",
          "--user",
          "the_user",
          "--password",
          "their_password",
          "--role",
          "the_role"
          "--database",
          "the_database",
          "--schema",
          "the_schema",
          # 可选: "--allow_write" (但不推荐)
          # 可选: "--log_dir", "/absolute/path/to/logs"
          # 可选: "--log_level", "DEBUG"/"INFO"/"WARNING"/"ERROR"/"CRITICAL"
          # 可选: "--exclude_tools", "{tool name}", ["{other tool name}"]
      ]
  }
}

本地安装

# 将服务器添加到您的 claude_desktop_config.json
"mcpServers": {
  "snowflake_local": {
      "command": "uv",
      "args": [
          "--directory",
          "/absolute/path/to/mcp_snowflake_server",
          "run",
          "mcp_snowflake_server",
          "--account",
          "the_account",
          "--warehouse",
          "the_warehouse",
          "--user",
          "the_user",
          "--password",
          "their_password",
          "--role",
          "the_role"
          "--database",
          "the_database",
          "--schema",
          "the_schema",
          # 可选: "--allow_write" (但不推荐)
          # 可选: "--log_dir", "/absolute/path/to/logs"
          # 可选: "--log_level", "DEBUG"/"INFO"/"WARNING"/"ERROR"/"CRITICAL"
          # 可选: "--exclude_tools", "{tool name}", ["{other tool name}"]
      ]
  }
}