MCP Snowflake Service

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

此服务器实现了模型上下文协议，能让Claude在Snowflake数据库上执行各类操作，包括执行SQL查询、自动管理数据库连接生命周期、处理查询结果和错误，还能安全地执行数据库操作，为数据交互提供了高效且安全的解决方案。

🚀 快速开始

安装与配置

按照以下步骤进行安装和配置，即可让Claude顺利访问Snowflake数据库。

📦 安装指南

通过 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 查询并高效处理结果。

💻 使用示例

安装依赖

安装所需的 Python 包：

pip install snowflake-sqlalchemy sqlalchemy click

配置 Snowflake 访问权限

为确保安全，建议创建一个只具有读取权限的数据库用户，并将其用于此服务。

启动服务器

使用以下命令启动 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. 语言流畅性：确保翻译后的文本表达自然，同时保持专业性和技术细节的准确性。

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