🚀 DiceDB MCP 服务端实现
这是一个用于实现 AI 应用程序（宿主/客户端）与 DiceDB 数据库服务器之间交互的服务端。它基于 模型上下文协议 (MCP)，并使用 DiceDB Go SDK 与 DiceDB 进行通信。查看 演示视频，了解其运行情况！
🚀 快速开始
本服务端可让 AI 应用程序与 DiceDB 数据库服务器进行交互，使用 MCP 协议通信，为数据交互提供便利。
✨ 主要特性
- 🔌
PING DiceDB：检查与 DiceDB 的连接性。 - 💬
通过 DiceDB 回显消息：实现消息的回显功能。 - 📖
根据键从 DiceDB 获取值：方便获取数据库中的数据。 - 📝
在 DiceDB 中设置键值对：灵活存储数据。 - 🗑️
删除一个或多个键的值从 DiceDB：清理不需要的数据。 - ➕
增加某个键的整数值一：对数值进行递增操作。 - ➖
减少某个键的整数值一：对数值进行递减操作。
📦 安装指南
下载二进制文件
你可以从 "Releases" 页下载适用于你的操作系统和处理器架构的适当二进制文件：下载。
使用 Go 安装
先决条件：
- Go 1.24 或更高版本
go install github.com/pottekkat/dicedb-mcp@latest
获取 dicedb-mcp 可执行文件的路径：
which dicedb-mcp
从源代码构建
请参阅下方的 开发 部分。
💻 使用示例
基础用法
带 MCP 宿主/客户端
将以下内容添加到你的 claude_desktop_config.json（用于 Claude Desktop）或 mcp.json（用于 Cursor）中：
{
"mcpServers": {
"dicedb-mcp": {
"command": "path/to/dicedb-mcp"
}
}
}
带 OpenAI 代理 SDK
以下示例展示了如何使用 dicedb-mcp 服务端与 OpenAI 代理 SDK：
from agents import Agent, Runner, trace
from agents.mcp import MCPServer, MCPServerStdio
from dotenv import load_dotenv
import os
import openai
import asyncio
load_dotenv()
async def run(mcp_server: MCPServer, prompt: str, server_url: str):
agent = Agent(name="dicedb-mcp",
system_prompt="You are an AI assistant that interacts with the DiceDB database using the Model Context Protocol (MCP).")
runner = Runner(agent, print_steps=True)
result = await runner.run(
"Use the MCP protocol to interact with the DiceDB database as specified by the user's prompt.",
mcp_server=mcp_server,
server_url=server_url,
prompt=prompt
)
return result
async def main():
# 初始化 MCPServerStdio 实例
mcp_server = await MCPServerStdio.create()
# 添加自定义路由
mcp_server.add_route("/custom", lambda: "Custom route response")
# 启动服务器
server_url = await mcp_server.start()
# 运行示例
result = await run(mcp_server, "告诉我数据库中的内容。", server_url)
print(f"结果：{result}")
if __name__ == "__main__":
asyncio.run(main())
可用工具
ping- 检查连接性。echo- 通过 DiceDB 回显消息。get- 根据键从 DiceDB 获取值。set- 在 DiceDB 中设置键值对。delete- 删除一个或多个键的值从 DiceDB。increment- 增加某个键的整数值一。decrement- 减少某个键的整数值一。
📚 详细文档
开发
克隆仓库
git clone https://github.com/pottekkat/dicedb-mcp.git
cd dicedb-mcp
构建项目
make deps # 安装依赖项
make build # 编译项目
运行测试
make test
配置本地构建
编辑 config.go 文件以配置你的本地环境。
📄 许可证
此项目使用 MIT 许可证，具体内容如下：
MIT License
Copyright (c) 2023-present pottekkat
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.