Aiven

🚀 Aiven MCP サーバー

Aiven Model Context Protocol (MCP) のサーバー実装で、Aiven 向けに特別に設計されています。

このサーバーは、Aiven 上の PostgreSQL、Kafka、ClickHouse、Valkey、OpenSearch サービスや、より広範な Aiven エコシステム内のネイティブコネクタへのアクセスを提供します。大規模言語モデル (LLMs) がすべてのユースケースに適した完全なスタックソリューションを構築できるようにします。

✨ 主な機能

ツール

• list_projects
  • Aiven アカウント内のすべてのプロジェクトをリストします。
• list_services
  • 特定の Aiven プロジェクト内のすべてのサービスをリストします。
• get_service_details
  • 特定の Aiven プロジェクト内のサービス詳細を取得します。

📦 インストール

Claude Desktop 用の設定

1. 以下の場所にある Claude Desktop の設定ファイルを開きます：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
2. 以下の内容を追加します：

{
  "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 ログイントークン に設定します。

3. コマンドエントリ「uv」を見つけ、絶対パスで置き換えて、サーバー起動時に正しい「uv」バージョンが使用されるようにします。macOS では which uv を使用してこのパスを見つけることができます。
4. Claude Desktop を再起動して変更を適用します。

Cursor 用の設定

1. Cursor で設定 -> Cursor 設定に移動します。
2. 「MCP サーバー」を選択します。
3. 新しいサーバーを追加します：
   • 名前: 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 を変数として追加する必要がある場合があります。

💻 使用例

開発手順

1. リポジトリのルートディレクトリにある .env ファイルに以下の内容を追加します：

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

2. 「uv」ツールをインストールします：
   • macOS では brew install uv toolkit/tap/uv を使用します。
   • Linux では uv インストールドキュメント を参照します。
3. 依存関係を同期します：

npm install

4. テストサーバーを起動します：

npm start

🔧 技術詳細

MCP と AI エージェントに関する開発者向け注意事項

• ユーザーは MCP の実行に対する完全な制御と責任を保持します。
• AI エージェントの権限は直接 API トークンの権限に関連しています。
• AI エージェントに資格情報を提供する際は極度に注意してください。
• API トークンを管理する際は最小特権の原則を厳格に遵守してください。