Aiven MCP サーバー

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

特徴

ツール

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

Related MCP server: MCP Salesforce Connector

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トークンのベストプラクティス: