Provides an interface for AI agents to interact with KevoDB, a key-value database, enabling operations like basic key-value operations, range/prefix/suffix scans, transactions, batch operations, and database statistics retrieval.
KevoDB MCP Server
This project implements a MCP (Multimodal Communication Protocol) server for KevoDB, allowing AI agents to interact with KevoDB using a standardized API.
Features
- Exposes KevoDB operations through MCP tools
- Supports all core KevoDB functionality:
- Basic key-value operations (get, put, delete)
- Range, prefix, and suffix scans
- Transactions
- Batch operations
- Database statistics
- Simple string-based API with UTF-8 encoding
Prerequisites
- Python 3.8+
- Running KevoDB server (default: localhost:50051)
- FastMCP library
- Python-Kevo SDK
Installation
- Install dependencies:
- Ensure KevoDB is running on localhost:50051 (or set the
KEVO_HOST
andKEVO_PORT
environment variables to connect to a different endpoint)
Usage
Running the MCP Server
Start the MCP server:
This will launch the MCP server on http://localhost:9000/mcp
You can configure the KevoDB connection using environment variables:
KEVO_HOST
: Hostname of the KevoDB server (default: "localhost")KEVO_PORT
: Port of the KevoDB server (default: "50051")
Example:
Using with AI Agents
AI agents that support MCP can connect to this server and use all exposed tools. The server provides the following tools:
Tool | Description |
---|---|
connect | Connect to the KevoDB server |
get | Get a value by key from KevoDB |
put | Store a key-value pair in KevoDB |
delete | Delete a key-value pair from KevoDB |
scan | Scan keys in KevoDB with options |
batch_write | Perform multiple operations in a batch |
get_stats | Get database statistics |
begin_transaction | Begin a new transaction and return transaction ID |
commit_transaction | Commit a transaction by ID |
rollback_transaction | Roll back a transaction by ID |
tx_put | Store a key-value pair within a transaction |
tx_get | Get a value by key within a transaction |
tx_delete | Delete a key-value pair within a transaction |
cleanup | Close the KevoDB connection |
Integration with AI Applications
To use KevoDB with your AI application:
- Start the KevoDB server
- Start this MCP server
- Configure your AI agent to connect to the MCP endpoint
- The AI agent can now use all KevoDB operations through the MCP interface
License
This server cannot be installed
Implements a Multimodal Communication Protocol server for KevoDB, allowing AI agents to interact with the key-value database through a standardized API with support for core operations like get/put, scans, transactions, and batch operations.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.Last updated -61079TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that allows AI agents to execute SQL queries against a MySQL database, supporting operations like reading data, creating tables, inserting, updating, and deleting records.Last updated -64771JavaScript
- -securityAlicense-qualityA Model Context Protocol (MCP) server that provides read-only TDengine database queries for AI assistants, allowing users to execute queries, explore database structures, and investigate data directly from AI-powered tools.Last updated -4PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides read-only MySQL database queries for AI assistants, allowing them to execute queries, explore database structures, and investigate data directly from AI-powered tools.Last updated -3401TypeScriptMIT License