WAII MCP Server

WAII MCP Server

一个 Model Context Protocol 服务，可通过 WAII 提供数据库交互能力。该服务使大语言模型能够通过自然语言与数据库交互、执行查询并处理数据库内容。

可用工具

database

通过 WAII 的自然语言界面与数据库交互。

参数：

• database-key（字符串，必填）：数据库连接字符串
• api-key（字符串，必填）：WAII API 密钥
• url（字符串，必填）：WAII API 端点 URL

安装

使用 uv/uvx（推荐）

使用 uv/uvx 时无需进行特定安装。你可以通过以下任一方式直接运行该服务：

使用 uv：

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"

要求

• 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"

功能

• 将自然语言转换为 SQL
• 数据库架构理解与管理
• 查询执行与结果格式化
• 自动提供查询优化建议
• 数据可视化能力

开发

设置开发环境：

1. 克隆仓库

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

2. 以开发模式安装：

uv pip install -e .

支持

如需支持：

1. 查看 GitHub Issues
2. 有关 API 的问题，请联系 WAII 支持团队
3. 如果发现错误，请新建一个 issue

许可证

Apache License 2.0 - 详情请参阅 LICENSE 文件。