Aiven
About
Manage Aiven cloud services like Kafka, PostgreSQL, and Redis via its API.
Details
- Author
- johnkennedyoss
- Categories
- Cloud Service, Infrastructure, Other, API
Jump to
Setup
Install Aiven in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/johnkennedyoss/mcp-demo
Follow the installation instructions in the repository README, then restart your MCP client.
A simple Docker container for the MCP Aiven server.
- Create a.envfile with your Aiven credentials:
# Aiven API configuration AIVEN_BASE_URL=https://api.aiven.io AIVEN_PROJECT_NAME=your-project-name # Aiven Authentication Token AIVEN_TOKEN=your-token-here
- Access the server athttp://localhost:8000
- GET /: HTML page showing the server status and environment variables
- GET /api/projects: JSON response with the list of projects
- List all projects on your Aiven account.
- List all services in a specific Aiven project.
- Get the detail of your service in a specific Aiven project.
- Get the metadata of a specific Aiven service, currently only working for Aiven for PostgreSQL®.
- Run a query against a specific Aiven service, currently only working for Aiven for PostgreSQL®.
-
Open the Claude Desktop configuration file located at:
- On macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "mcp-clickhouse": { "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_PROJECT_NAME": "$DEFAULT_PROJECT_NAME", "AIVEN_TOKEN": "$AIVEN_TOKEN" } } } }
- $REPOSITORY_DIRECTORYto point to the folder cointaining the repository
- AIVEN_PROJECT_NAMEto the default project name
- AIVEN_TOKENto theAiven login token.
-
Locate the command entry foruvand replace it with the absolute path to theuvexecutable. This ensures that the correct version ofuvis used when starting the server. On a mac, you can find this path usingwhich uv.
Restart Claude Desktop to apply the changes.
-
Navigate to Cursor -> Settings -> Cursor Settings
- Name:mcp-aiven
- Type:command
- Command:uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven
Where$REPOSITORY_DIRECTORYis the path to the repository. You might need to add theAIVEN_BASE_URL,AIVEN_PROJECT_NAMEandAIVEN_TOKENas variables
- Add the following variables to a.envfile in the root of the repository.
AIVEN_BASE_URL=https://api.aiven.io AIVEN_PROJECT_NAME=$DEFAULT_PROJECT_NAME AIVEN_TOKEN=$AIVEN_TOKEN
-
Runuv syncto install the dependencies. To installuvfollow the instructionshere. Then dosource .venv/bin/activate.
For easy testing, you can runmcp dev mcp_aiven/mcp_server.pyto start the MCP server.
The following environment variables are used to configure the ClickHouse connection:
- AIVEN_BASE_URL: The Aiven API url
- AIVEN_PROJECT_NAME: The default project name
- AIVEN_TOKEN: The authentication token =======
Demo private repo for testing mcp hosting on Aiven.
Deploy full-stack apps (Postgres, Redis, S3, workers, backups) from Claude or curl. 59 MCP tools
A Next.js template for building MCP servers with OAuth 2.1 authentication, supporting PostgreSQL and Redis.
Access and manage your Supabase projects through the Model Context Protocol (MCP).
Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Automate Akamai resource actions using a conversational AI client. Requires Akamai API credentials.
Exposes API-Market's endpoints as MCP resources, requiring an API key for access.
Interact with the Appwrite API to manage databases, users, storage, and more. Requires configuration via environment variables.
Interact with the Appwrite API to manage your backend services.
A Node.js server for the Model Context Protocol that provides access to the Autodesk Platform Services (APS) API with fine-grained access control.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




