Snowflake连接器

轻量级Snowflake MCP服务器,通过自然语言连接AI助手与Snowflake,提供安全查询、缓存和审计功能。

  • by Evan-Kim2028
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Evan-Kim2028/igloo-mcp

使用说明

冰屋MCP

一个轻量级的Snowflake MCP服务器,通过内置的安全、缓存和审计功能将您的AI助手连接到Snowflake。通过自然语言查询数据库、构建目录和创建实时报告。

为什么选择冰屋MCP?

🔒 安全查询

默认情况下阻止危险的DDL/DML,自动取消慢速查询,并记录每次执行。使用 execute_query 配备可配置的护栏 test_connection 在运行查询之前验证身份验证。

⚡ 更快地工作

通过渐进式披露和智能结果缓存,最大限度地减少令牌使用。工具如 get_report 支持多种检索模式(摘要/部分/见解/完整),以及 search_catalog 让你在不点击雪花的情况下找到桌子。

📋 保持审计

维护完整的查询历史记录,包括源归因,以进行合规性跟踪。每 execute_query 通话记录到历史记录,动态报告通过以下方式跟踪所有修改并提供完整的审计跟踪 evolve_report.

📊 构建实时报告

创建可审计、不断发展的业务报告 create_report,使用以下命令安全地修改它们 evolve_report,将图表附加到见解中,并通过导出到HTML/PDF/Markdown render_report.

快速开始

先决条件

# Install igloo-mcp
uv pip install igloo-mcp

# Configure Snowflake connection (uses Snowflake CLI)
snow connection add --connection-name quickstart --account <account> --user <user> --authenticator externalbrowser --warehouse <warehouse>

光标设置

添加 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "igloo-mcp": {
      "command": "igloo_mcp",
      "args": ["--profile", "quickstart"]
    }
  }
}

重新启动Cursor并询问: “预览客户表”

Claude代码设置

从终端运行:

claude mcp add --scope user --transport stdio igloo-mcp -- igloo_mcp --profile quickstart

或添加到 ~/.claude.json 手动:

{
  "mcpServers": {
    "igloo-mcp": {
      "type": "stdio",
      "command": "igloo_mcp",
      "args": ["--profile", "quickstart"]
    }
  }
}

重新启动Claude Code并询问: “显示数据库的架构”

备注:可执行文件是 igloo_mcp (下划线),不是 igloo-mcp 冲撞

完整设置指南: docs/installation.md

核心工具

🔍 查询与探索

工具 说明
execute_query 运行带有防护栏、超时和自动洞察的SQL
build_catalog 导出雪花元数据以进行离线搜索
search_catalog 无需查询Snowflake即可查找表/列
build_dependency_graph 可视化表沿袭和依赖关系

📊 实时报告

工具 说明
create_report 初始化可审计的JSON支持的报告
evolve_report 在法学硕士的协助和审计跟踪下修改报告
evolve_report_batch 以原子方式执行多个操作
render_report 通过Quarto导出为HTML、PDF或Markdown
get_report 阅读采用渐进式披露模式的报告
search_report 按标题或标签查找报告
search_citations 按来源类型或提供者搜索引文
get_report_schema 在运行时发现有效的结构和节模板
validate_report 质量检查:引用、空白部分、陈旧内容

🏥 健康与诊断

工具 说明
test_connection 验证Snowflake身份验证
health_check 监视服务器、配置文件和目录状态

查看全部16个工具: docs/api/TOOLS_INDEX.md

何时使用冰屋MCP

选择冰屋MCP 选择雪花实验室MCP
开发/分析工作流程的AI助手 生产Cortex AI集成
基于SnowCLI的简单设置 企业服务架构
查询安全+自动缓存 全面雪花对象管理
内置审计和合规性 基于容器的部署

资源


MIT许可证 |专为提高代理效率而设计