{"type":"mcp_server","name":"mcp-aiven","description":"This repository provides an Aiven Model Context Protocol (MCP) server, enabling Large Language Models to interact with Aiven services like PostgreSQL, Kafka, and OpenSearch. It offers tools for managing Aiven","category":"AI","language":"Python","stars":23,"forks":1,"owner":"Aiven-Open","github_url":"https://github.com/Aiven-Open/mcp-aiven","homepage":null,"setup":"## Setup\n\n**Configuration for Claude Desktop**\n\n1.  Open the Claude Desktop configuration file located at:\n    *   On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n    *   On Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n2.  Add the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-aiven\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"$REPOSITORY_DIRECTORY\",\n        \"run\",\n        \"--with-editable\",\n        \"$REPOSITORY_DIRECTORY\",\n        \"--python\",\n        \"3.13\",\n        \"mcp-aiven\"\n      ],\n      \"env\": {\n        \"AIVEN_BASE_URL\": \"https://api.aiven.io\",\n        \"AIVEN_TOKEN\": \"$AIVEN_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nUpdate the environment variables:\n*   `$REPOSITORY_DIRECTORY` to point to the folder cointaining the repository\n*   `AIVEN_TOKEN` to the [Aiven login token](https://aiven.io/docs/platform/howto/create_authentication_token).\n\n\n3.  Locate the command entry for `uv` and replace it with the absolute path to the `uv` executable. This ensures that the correct version of `uv` is used when starting the server. On a mac, you can find this path using `which uv`.\n\n4.  Restart Claude Desktop to apply the changes.\n\n**Configuration for Cursor**\n\n1.  Navigate to Cursor -> Settings -> Cursor Settings\n\n2.  Select \"MCP Servers\"\n\n3.  Add a new server with\n\n    *   Name: `mcp-aiven`\n    *   Type: `command`\n    *   Command: `uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven`\n\nWhere `$REPOSITORY_DIRECTORY` is the path to the repository. You might need to add the `AIVEN_BASE_URL`, `AIVEN_PROJECT_NAME` and `AIVEN_TOKEN` as variables\n\n**Development**\n\n1.  Add the following variables to a `.env` file in the root of the repository.\n\n```\nAIVEN_BASE_URL=https://api.aiven.io\nAIVEN_TOKEN=$AIVEN_TOKEN\n```\n\n2.  Run `uv sync` to install the dependencies. To install `uv` follow the instructions [here](https://docs.astral.sh/uv/). Then do `source .venv/bin/activate`.\n\n3.  For easy testing, you can run `mcp dev mcp_aiven/mcp_server.py` to start the MCP server.","tools":"## Available Tools\n\n\t\t1. `list_projects` (List all projects on your Aiven account.)\n\t\t2. `list_services` (List all services in a specific Aiven project.)\n\t\t3. `get_service_details` (Get the detail of your service in a specific Aiven project.)","faq":null,"created_at":"2025-03-13T07:34:49+00:00","updated_at":"2025-03-24T08:27:52+00:00","source_url":"https://model-context-protocol.com/servers/aiven-model-context-protocol-server","related_articles":[]}