mcp-everest

# Unofficial Percona Everest MCP Server An unofficial MCP (Model Context Protocol) server implementation for [Percona Everest](https://docs.percona.com/everest/index.html) - an open-source cloud native database platform. This server enables AI-powered interaction with Percona Everest database clusters through a standardized protocol. ## Available Tools The MCP server provides the following tools for interacting with Percona Everest: - `list_database_clusters(namespace)`: Lists all available database clusters in the specified namespace - `get_database_cluster(namespace, name)`: Retrieves detailed information about a specific database cluster - `get_database_cluster_credentials(namespace, name)`: Fetches credentials for a specific database cluster - `get_database_cluster_components(namespace, name)`: Gets components information for a specific database cluster ## Development Setup 1. Clone the repository: ```bash git clone https://github.com/spron-in/mcp-everest cd mcp-everest uv venv source .venv/bin/activate ``` 2. Set up environment variables: ```bash # Required export EVEREST_API_KEY="your-api-key" # Optional with defaults export EVEREST_HOST="http://localhost:8080" # Everest API base URL export EVEREST_VERIFY_SSL="true" # SSL verification export EVEREST_TIMEOUT="30" # Request timeout in seconds export EVEREST_READONLY="false" # Read-only mode ``` Read [Percona Everest documentation](https://docs.percona.com/everest/API.html) to learn more about API. I sent a [pull request](https://github.com/percona/everest-doc/pull/255) that explains how to get the API (JWT) key, hope it is going to be accepted soon. 3. Run the server: ```bash uv run --with mcp-everest mcp-everest ``` ## Testing and playing ### Testing with [MCP Inspector](https://github.com/modelcontextprotocol/inspector) To test the server with the MCP development client: ```bash mcp dev mcp_everest/mcp_server.py ``` This requires Node to be installed. It will start a NodeJS MCP Inspector that you can open in your browser and play with. ### Example mcp_client.py There is also a client that can be used to interact with the MCP server: ```bash python mcp_client.py ``` This is the example of how Large Language Model can talk to an MCP and use its tools. Read more in the [blog post](https://spron.in/blog/tpost/iksv5fzx91-fun-with-mcp-and-percona-everest). ## Future Development ### Planned Improvements 1. **Official Integration** - Work towards making this an official MCP server for Percona Everest - Submit for inclusion in popular MCP server collections 2. **API Coverage Expansion** - Implement more GET endpoints from the Everest API - Add support for POST/PUT/DELETE operations (but have read-only mode available) - Add proper types and supported variables from API spec - Include resources and prompts into MCP 3. **Cross-Integration** - Integrate with other database MCP servers (MongoDB, PostgreSQL, etc.) - Enable cross-database operations and management - Implement unified monitoring across different database platforms ### Contributing Contributions are welcome! Feel free to submit issues and pull requests.