Waii MCP Server

🚀 WAII MCP 服務器

WAII MCP 服務器是一個模型上下文協議（MCP）服務器，藉助 WAII 實現數據庫交互功能。它允許語言模型通過自然語言與數據庫進行交互、執行查詢並處理數據庫內容。

🚀 快速開始

本服務器可使語言模型藉助自然語言與數據庫交互，為數據處理提供便利。下面為您詳細介紹使用前的準備。

✨ 主要特性

• 自然語言到 SQL 轉換
• 數據庫模式理解和管理
• 查詢執行和結果格式化
• 自動查詢優化建議
• 數據可視化功能

📦 安裝指南

使用 uv/uvx（推薦）

使用 uv/uvx 無需任何特定安裝，您可以直接運行服務器：

uv run -m mcp_server_waii \
  --url "YOUR_WAII_URL" \
  --api-key "YOUR_API_KEY" \
  --database-key "YOUR_DATABASE_CONNECTION_STRING"

使用 pip

您也可以通過 pip 安裝 mcp-server-waii：

pip install mcp-server-waii

安裝後，將其作為模塊運行：

python -m mcp_server_waii \
  --url "YOUR_WAII_URL" \
  --api-key "YOUR_API_KEY" \
  --database-key "YOUR_DATABASE_CONNECTION_STRING"

📚 詳細文檔

可用工具

數據庫

通過 WAII 的自然語言接口與數據庫交互。

要求

• Python 3.10 或更高版本
• 具有 API 訪問權限的 WAII 賬戶
• 支持 WAII 的數據庫憑證

配置

配置用於 Claude.app

有幾種方法可以配置服務器以供 Claude 使用：

1. 使用 uvx（推薦）

{
    "mcpServers": {
        "waii": {
            "command": "uvx",
            "args": [
                "mcp_server_waii",
                "--url",
                "YOUR_WAII_URL",
                "--api-key",
                "YOUR_API_KEY",
                "--database-key",
                "YOUR_DATABASE_CONNECTION_STRING"
            ]
        }
    }
}

2. 使用 Python 安裝

{
    "mcpServers": {
        "waii": {
            "command": "python",
            "args": [
                "-m",
                "mcp_server_waii",
                "--url",
                "YOUR_WAII_URL",
                "--api-key",
                "YOUR_API_KEY",
                "--database-key",
                "YOUR_DATABASE_CONNECTION_STRING"
            ]
        }
    }
}

示例值：

• YOUR_WAII_URL：例如，“http://WAII_URL/api/”
• YOUR_API_KEY：您的 WAII API 密鑰
• YOUR_DATABASE_CONNECTION_STRING：例如，“snowflake://USER@HOST/DB?role=ROLE&warehouse=WAREHOUSE”

開發

要設置開發環境，可按以下步驟操作：

1. 克隆倉庫

git clone https://github.com/waii-ai/mcp-server-waii.git
cd mcp-server-waii

2. 以開發模式安裝：

uv pip install -e .

支持

若您需要尋求幫助，可按以下步驟操作：

1. 檢查GitHub 問題
2. 聯繫 WAII 支持以獲取 API 相關問題解答
3. 發現錯誤時提交新問題

📄 許可證

本項目採用 Apache License 2.0，有關詳細信息，請參閱 LICENSE 文件。