local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to Aiven for ClickHouse services, allowing interaction with analytical databases hosted on the Aiven platform.
Enables working with Aiven for OpenSearch services, providing tools to interact with search and analytics capabilities.
Enables interaction with Aiven for PostgreSQL services, allowing access to database resources hosted on the Aiven platform.

Aiven MCP サーバー

これにより、Aivenで実行されるPostgreSQL、Kafka、ClickHouse、Valkey、OpenSearchなどのAivenサービス、およびネイティブコネクタを含むより広範なAivenエコシステムへのアクセスが可能になります。LLMはあらゆるユースケースに対応するフルスタックソリューションを構築できます。

特徴

ツール

list_projects
- Aiven アカウントのすべてのプロジェクトを一覧表示します。
list_services
- 特定の Aiven プロジェクト内のすべてのサービスを一覧表示します。
get_service_details
- 特定の Aiven プロジェクトにおけるサービスの詳細を取得します。

Claudeデスクトップの設定

次の場所にある Claude Desktop 構成ファイルを開きます。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
以下を追加します。

{
  "mcpServers": {
    "mcp-aiven": {
      "command": "uv",
      "args": [
        "--directory",
        "$REPOSITORY_DIRECTORY",
        "run",
        "--with-editable",
        "$REPOSITORY_DIRECTORY",
        "--python",
        "3.13",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_BASE_URL": "https://api.aiven.io",
        "AIVEN_TOKEN": "$AIVEN_TOKEN"
      }
    }
  }
}

環境変数を更新します。

$REPOSITORY_DIRECTORYリポジトリを含むフォルダを指します
AIVEN_TOKENをAiven ログイントークンに変換します。

uvのコマンドエントリを見つけ、 uv実行ファイルへの絶対パスに置き換えます。これにより、サーバーの起動時に正しいバージョンのuvが使用されるようになります。Macでは、 which uvでこのパスを確認できます。
変更を適用するには、Claude Desktop を再起動します。

カーソルの設定

「カーソル」→「設定」→「カーソル設定」へ移動します。
「MCPサーバー」を選択
新しいサーバーを追加する
- 名前: mcp-aiven
- タイプ: command
- コマンド: uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven

$REPOSITORY_DIRECTORYリポジトリへのパスです。AIVEN_BASE_URL、 AIVEN_PROJECT_NAME 、 AIVEN_TOKEN変数として追加する必要AIVEN_BASE_URLあるかもしれません。

発達

リポジトリのルートにある.envファイルに次の変数を追加します。

AIVEN_BASE_URL=https://api.aiven.io
AIVEN_TOKEN=$AIVEN_TOKEN

uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
簡単にテストするには、 mcp dev mcp_aiven/mcp_server.pyを実行して MCP サーバーを起動できます。

環境変数

Aiven 接続を構成するには、次の環境変数が使用されます。

必須変数

AIVEN_BASE_URL : Aiven API の URL
AIVEN_TOKEN : 認証トークン

モデルコンテキストプロトコル（MCP）とAIエージェントに関する開発者の考慮事項

このセクションでは、このシステム内でモデルコンテキストプロトコル（MCP）とAIエージェントを使用する際の開発者の主な責任とセキュリティ上の考慮事項について説明します。セルフマネージドMCP：

お客様の責任： MCPはAivenによってホストされるのではなく、お客様の環境内で実行されます。したがって、お客様は、共有責任モデルに従い、運用管理、セキュリティ、コンプライアンスについて単独で責任を負います。( https://aiven.io/responsibility-matrix )
**展開と保守:**開発者は、MCP の展開、更新、保守のあらゆる側面を処理する必要があります。

AIエージェントのセキュリティ:

権限制御： AIエージェントのアクセスと機能は、認証に使用されるAPIトークンに付与された権限によって厳密に制御されます。開発者はこれらの権限を綿密に管理する必要があります。
認証情報の取り扱い： AIエージェントがユーザーに代わってアクションを実行する際に、アクセス認証情報（例：データベース接続文字列、ストリーミングサービストークン）が必要となる場合があることにご注意ください。AIエージェントにそのような認証情報を提供する際は、細心の注意を払ってください。
リスク評価: AI エージェントに機密リソースへのアクセスを許可する前に、組織のセキュリティポリシーを遵守し、徹底したリスク評価を実施してください。

APIトークンのベストプラクティス:

**最小権限の原則：**常に最小権限の原則を遵守してください。APIトークンは、その機能に必要な最小限の権限に限定してスコープを設定する必要があります。
**トークン管理:**定期的なローテーションや安全な保管など、堅牢なトークン管理プラクティスを実装します。

重要なポイント:

ユーザーは、MCP の実行とセキュリティに対する完全な制御と責任を保持します。
AI エージェントの権限は、API トークンの権限に直接関連付けられています。
AI エージェントに資格情報を提供するときは、細心の注意を払ってください。
API トークンを管理するときは、最小権限の原則に厳密に従ってください。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Aiven サービス (PostgreSQL、Kafka、ClickHouse、Valkey、OpenSearch) へのアクセスを提供し、LLM がこれらのサービスと対話してフルスタックソリューションを構築できるようにするモデルコンテキストプロトコルサーバー。

Aiven MCP Server