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. 語言流暢性：確保翻譯後的文本表達自然，同時保持專業性和技術細節的準確性。

通過以上步驟，可以保證用戶獲得一份清晰、準確且易於理解的中文項目說明文檔。