MCP Snowflake Service

🚀 模型上下文协议（MCP）服务器——Claude Snowflake数据库访问服务

本项目实现的模型上下文协议（MCP）服务器，为Claude提供了安全、高效的Snowflake数据库访问能力。它能自动管理数据库连接，处理查询结果与错误，让Claude可以在Snowflake上顺畅执行SQL查询。

🚀 快速开始

此服务器实现了模型上下文协议，使 Claude 能够：

• 在 Snowflake 数据库上执行 SQL 查询
• 自动管理数据库连接生命周期（连接创建、超时重连、连接关闭）
• 处理查询结果和错误
• 安全地执行数据库操作

📦 安装指南

通过 Smithery 安装

要自动通过 Smithery 安装 mcp-service-snowflake 用于 Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @datawiz168/mcp-service-snowflake --client claude

手动安装

如果需要手动运行服务器进行测试，可以使用以下命令：

python server.py

⚠️ 重要提示

正常使用时无需手动启动服务器，Claude Desktop 客户端会根据配置自动管理服务器的启动和停止。

📚 详细文档

配置说明

环境变量配置

在 ~/.config/claude/settings.json 中添加以下内容：

{
  "snowflakeEnabled": true,
  "snowflakeEndpoint": "your_snowflake_endpoint",
  "snowflakeUser": "your_snowflake_user",
  "snowflakePassword": "your_snowflake_password"
}

✨ 主要特性

• 安全的 Snowflake 数据库访问：通过数据库用户精确控制访问权限。
• 健壮的错误处理和报告机制：确保在出现错误时能够及时发现和处理。
• 自动连接管理：服务器启动时自动建立连接，停止时自动释放资源。
• 查询执行和结果处理：支持执行复杂 SQL 查询并高效处理结果。

💻 使用示例

基础用法

1. 安装依赖 安装所需的 Python 包：

pip install snowflake-sqlalchemy sqlalchemy click

2. 配置 Snowflake 访问权限 为确保安全，建议创建一个只具有读取权限的数据库用户，并将其用于此服务。
3. 启动服务器 使用以下命令启动 MCP 服务器：

python server.py

🛠️ 开发贡献

贡献代码或报告问题

1. Fork 此仓库。
2. 创建功能分支：git checkout -b feature/AmazingFeature
3. 提交更改：git commit -m 'Add some AmazingFeature'
4. 推送到分支：git push origin feature/AmazingFeature
5. 提交 Pull Request。

备注

MCP-Server-Snowflake 通过数据库用户精确控制访问权限。如果仅需读取数据，为用户提供只读数据库权限即可。

📄 许可证

此项目采用 MIT 许可证。

附录：完整翻译说明

为确保翻译的准确性和完整性，以下几点需要注意：

1. 技术术语一致性：如“Model Context Protocol (MCP)”统一译为“模型上下文协议（MCP）”。
2. 代码块处理：保留所有命令和路径的英文格式，并在适当位置添加中文注释以便理解。
3. 语言流畅性：确保翻译后的文本表达自然，同时保持专业性和技术细节的准确性。

通过以上步骤，可以保证用户获得一份清晰、准确且易于理解的中文项目说明文档。