WAII MCP Server
About
A Model Context Protocol server that provides database interaction capabilities through WAII. It enables Language Models to interact with databases, execute queries, and process database content using natural language. Designed for developers and AI assistants needing database…
Details
- Author
- waii-ai
- GitHub stars
- 7
- Downloads
- 103
- Categories
- Other
Jump to
- Natural language to SQL conversion
- Database schema understanding and management
- Query execution and result formatting
- Automatic query optimization suggestions
- Data visualization capabilities
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WAII MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server using uv/uvx (recommended) or pip install mcp-server-waii. Run it with uv run -m mcp_server_waii or python -m mcp_server_waii, supplying --url, --api-key, and --database-key arguments. Configure it for Claude.app by adding a JSON entry under mcpServers with the appropriate command and arguments.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"waii mcp server": {
"waii-mcp-server": {
"command": "uv",
"args": [
"run",
"-m",
"mcp_server_waii",
"\\"
]
}
}
}
}McpServers
{
"waii-mcp-server": {
"command": "uv",
"args": [
"run",
"-m",
"mcp_server_waii",
"\\"
]
}
}WAII MCP Server
A Model Context Protocol server that provides database interaction capabilities through WAII. This server enables Language Models to interact with databases, execute queries, and process database content through natural language.
Available Tools
database
Interact with databases through WAII's natural language interface.Arguments:
- database-key (string, required): Your database connection string
- api-key (string, required): Your WAII API key
- url (string, required): WAII API endpoint URL
Installation
Using uv/uvx (recommended)
When using uv/uvx no specific installation is needed. You can directly run the server using either approach:Using uv:
uv run -m mcp_server_waii \
--url "YOUR_WAII_URL" \
--api-key "YOUR_API_KEY" \
--database-key "YOUR_DATABASE_CONNECTION_STRING"
Using pip
Alternatively, you can install mcp-server-waii via pip:pip install mcp-server-waii
After installation, you can run it as a module:
python -m mcp_server_waii \
--url "YOUR_WAII_URL" \
--api-key "YOUR_API_KEY" \
--database-key "YOUR_DATABASE_CONNECTION_STRING"
Requirements
- Python 3.10 or higher
- A WAII account with API access
- Database credentials supported by WAII
Configuration
Configure for Claude.app
There are several ways to configure the server for Claude:
1. Using uvx (Recommended)
{
"mcpServers": {
"waii": {
"command": "uvx",
"args": [
"mcp_server_waii",
"--url",
"YOUR_WAII_URL",
"--api-key",
"YOUR_API_KEY",
"--database-key",
"YOUR_DATABASE_CONNECTION_STRING"
]
}
}
}
2. Using Python installation
{
"mcpServers": {
"waii": {
"command": "python",
"args": [
"-m",
"mcp_server_waii",
"--url",
"YOUR_WAII_URL",
"--api-key",
"YOUR_API_KEY",
"--database-key",
"YOUR_DATABASE_CONNECTION_STRING"
]
}
}
}
Example Values:
-YOUR_WAII_URL: e.g., "http://WAII_URL/api/"
- YOUR_API_KEY: Your WAII API key
- YOUR_DATABASE_CONNECTION_STRING: e.g., "snowflake://USER@HOST/DB?role=ROLE&warehouse=WAREHOUSE"
Features
- Natural language to SQL conversion
- Database schema understanding and management
- Query execution and result formatting
- Automatic query optimization suggestions
- Data visualization capabilities
Development
To set up the development environment:
1. Clone the repository
git clone https://github.com/waii-ai/mcp-server-waii.git
cd mcp-server-waii
2. Install in development mode:
uv pip install -e .
Support
For support:
1. Check the GitHub Issues
2. Contact WAII support for API-related questions
3. Open a new issue if you find a bug
License
Apache License 2.0 - see LICENSE file for details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
