冰屋MCP
](https://pypi.org/project/igloo-mcp/) ](https://github.com/Evan-Kim2028/igloo-mcp/releases)  
一个轻量级的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 --user --authenticator externalbrowser --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许可证 |专为提高代理效率而设计
