数据库自然语言查询服务

一个本地模型上下文协议(MCP)服务器,允许Claude Desktop通过自然语言SQL与Snowflake数据库交互,展示现代LLMs如何通过安全本地工具集成企业数据系统。

  • by asingh49-cmd
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 asingh49-cmd/Local-Snowflake-MCP-Server

使用说明

本地雪花MCP服务器

当地人 模型上下文协议(MCP)服务器 使Claude Desktop能够与 雪花 通过自然语言SQL创建数据库。该项目内置Python,演示了现代LLM如何使用安全的本地工具与企业数据系统集成。


🔗 徽章


概述

此存储库包含:

  • A. Python MCP服务器 (snowflake_mcp_server.py)
  • claude_desktop_config.json文件的README中的说明/代码
  • 屏幕截图和文档 显示本地运行的MCP服务器
  • 连接Claude的说明→ MCP服务器→ 雪花安全

该项目演示了如何使用MCP构建自定义的AI驱动数据库工具。


存储库结构

snowflake-mcp-server/
│
├── server/
│ ├── snowflake_mcp_server.py
│ ├── requirements.txt
│
├── docs/
│ ├── screenshots/
│
└── README.md

入门指南

1.克隆存储库

git clone https://github.com/your-username/snowflake-mcp-server.git
cd snowflake-mcp-server
  1. 再进行
pip install -r server/requirements.txt
  1. 设置环境变量

SNOWFLAKE_USER=your_user
SNOWFLAKE_PASSWORD=your_password
SNOWFLAKE_ACCOUNT=your_account
SNOWFLAKE_WAREHOUSE=your_wh
SNOWFLAKE_DATABASE=your_db
SNOWFLAKE_SCHEMA=your_schema
  1. 运行MCP服务器
python server/snowflake_mcp_server.py
Expected output:

MCP Snowflake Server started...
Listening for Claude Desktop connections…
  1. 配置Claude桌面JSON

{
  "mcpServers": {
    "snowflake": {
      "command": "your_env_path",
      "args": [
        "your_server_path.py"
      ],
      "env": {
        "SF_ACCOUNT": "account_name",
        "SF_USER": "username",
        "SF_PASSWORD": "password",
        "SF_WH": "warehouse_name",
        "SF_DB": "database_name",
        "SF_SCHEMA": "schema_name"
      },
      "autoStart": true
    }
  }
}
Restart Claude. The tool should appear automatically.

克劳德提示示例 “运行查询以列出我的架构中的表。”

“显示MY_TABLE中的前10行。”

“解释此SQL查询的作用并建议优化。”

“使用示例值创建一个名为DEMO_TEST的表。”

🧱 Architecture

Claude Desktop
      │
      ▼
Local MCP Server (Python)
      │
      ▼
Snowflake Database

安全说明(重要!) 此回购不包括:

❌ 雪花证书 ❌ 硬编码密码 ❌ 个人帐户标识符