MCP Aiven

🚀 Aiven MCP サーバー

Aiven用の Model Context Protocol (MCP) サーバーです。

このサービスは、Aivenおよびより広範なAivenエコシステムで動作するPostgreSQL、Kafka、ClickHouse、Valkey、OpenSearchサービスにアクセスでき、ネイティブコネクタを通じてさらに多くのサービスに接続できます。大規模言語モデル (LLM) がすべてのユースケースに対する完全なスタックソリューションを構築できるようにします。

✨ 主な機能

ツール

• 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 実行ファイルの絶対パスに置き換えます。これにより、サーバーを起動する際に正しい 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 を変数として追加する必要がある場合があります。

💻 使用例

基本的な使用法

from aiven_mcp import list_projects, list_services, get_service_details

# 示例用法
print("项目列表:", list_projects())
print("服务列表:", list_services(project_name))
print("服务详细信息:", get_service_details(service_id))

🔧 注意事項

⚠️ 重要提示

• ユーザーはMCPの実行とセキュリティを完全に制御します。
• AIエージェントの権限は直接APIトークンの権限に関連しています。
• AIエージェントに資格情報を提供する際には、極度の慎重を期す必要があります。
• APIトークンを最小権限の原則に従って厳密に管理してください。