使用说明
KevoDB MCP服务器
该项目实现了 多模式通信协议 服务器 KevoDB,允许人工智能代理使用标准化的API与KevoDB进行交互。
特性
- 通过MCP工具公开KevoDB操作
- 支持所有核心KevoDB功能:
- 基本键值操作(get、put、delete)
- 范围、前缀和后缀扫描
- 交易
- 批量操作
- 数据库统计
- 使用UTF-8编码的简单基于字符串的API
先决条件
- Python 3.8+
- 正在运行KevoDB服务器(默认:本地主机:50051)
- FastMCP库
- Python Kevo SDK
安装
- 安装依赖项:
pip install fastmcp python-kevo
- 确保KevoDB在localhost:50051上运行(或设置
KEVO_HOST和KEVO_PORT连接到不同端点的环境变量)
用法
运行MCP服务器
启动MCP服务器:
python main.py
这将启动MCP服务器http://localhost:9000/mcp
您可以使用环境变量配置KevoDB连接:
KEVO_HOST:KevoDB服务器的主机名(默认:“localhost”)KEVO_PORT:KevoDB服务器的端口(默认值:“50051”)
例子:
KEVO_HOST=192.168.1.100 KEVO_PORT=5000 python main.py
与AI代理一起使用
支持MCP的AI代理可以连接到此服务器并使用所有公开的工具。服务器提供以下工具:
| 工具 | 说明 |
|---|---|
connect |
连接到KevoDB服务器 |
get |
从KevoDB按键获取值 |
put |
在KevoDB中存储键值对 |
delete |
从KevoDB中删除键值对 |
scan |
使用选项扫描KevoDB中的密钥 |
batch_write |
批量执行多个操作 |
get_stats |
获取数据库统计信息 |
begin_transaction |
开始新交易并返回交易ID |
commit_transaction |
按ID提交交易 |
rollback_transaction |
按ID回滚交易 |
tx_put |
在交易中存储键值对 |
tx_get |
在交易中按键获取值 |
tx_delete |
删除交易中的键值对 |
cleanup |
关闭KevoDB连接 |
与AI应用程序集成
要将KevoDB与您的AI应用程序一起使用:
- 启动KevoDB服务器
- 启动此MCP服务器
- 配置您的AI代理以连接到MCP端点
- AI代理现在可以通过MCP接口使用所有KevoDB操作
