Content
# 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`:
```bash
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:
```bash
pip install mcp-server-waii
```
After installation, you can run it as a module:
```bash
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)
```json
{
"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
```json
{
"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
```bash
git clone https://github.com/waii-ai/mcp-server-waii.git
cd mcp-server-waii
```
2. Install in development mode:
```bash
uv pip install -e .
```
## Support
For support:
1. Check the [GitHub Issues](https://github.com/waii-ai/mcp-server-waii/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.
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
markitdown
Python tool for converting files and office documents to Markdown.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
TrendRadar
TrendRadar: Your hotspot assistant for real news in just 30 seconds.
mempalace
The highest-scoring AI memory system ever benchmarked. And it's free.
mempalace
The highest-scoring AI memory system ever benchmarked. And it's free.