Waii MCP Server

🚀 WAII MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、WAIIを通じてデータベースとの対話機能を提供します。言語モデルが自然言語でデータベースと対話し、クエリを実行し、データベース内容を処理できるようにします。

🚀 クイックスタート

WAII MCPサーバーを使用することで、言語モデルが自然言語でデータベースと対話できます。以下に、サーバーの利用方法や機能について説明します。

✨ 主な機能

• 自然言語から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の自然言語インターフェースを通じてデータベースと対話できます。

パラメータ：

• database-key（文字列、必須）：データベース接続文字列
• api-key（文字列、必須）：WAII APIキー
• url（文字列、必須）：WAII APIエンドポイントURL

必要条件

• 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. API関連の質問についてはWAIIサポートに問い合わせる
3. エラーを発見した場合は新しい問題を提出する

📄 ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。詳細についてはLICENSEファイルを参照してください。