DiceDB MCP

DiceDB MCP

一个 Model Context Protocol（MCP） 服务实现，用于 DiceDB，让 AI 应用（主机／客户端）能够与 DiceDB 数据库服务进行交互。

此实现使用 DiceDB Go SDK 与 DiceDB 通信。

查看演示视频，了解其运行效果！

功能

• PING DiceDB，检查连接情况。
• 通过 DiceDB ECHO 一条消息。
• 根据键从 DiceDB GET 一个值。
• 在 DiceDB 中 SET 一个键值对。
• 从 DiceDB 中 DEL 一个或多个键。
• 将键的整数值递增 1。
• 将键的整数值递减 1。

安装

下载二进制文件

你可以从“Releases”页面下载适用于你的操作系统和处理器架构的二进制文件。

通过 Go 安装

前置条件：

• Go 1.24 或更高版本

go install github.com/pottekkat/dicedb-mcp@latest

获取 dicedb-mcp 二进制文件的路径：

which dicedb-mcp

从源代码构建

请参阅下方的开发部分。

用法

与 MCP 主机／客户端搭配使用

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 mcp.json 中：

{
    "mcpServers": {
        "dicedb-mcp": {
            "command": "path/to/dicedb-mcp"
        }
    }
}

与 OpenAI Agents SDK 搭配使用

以下示例展示如何将 dicedb-mcp 服务与 OpenAI Agents 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",
                  instructions=f"""You can interact with a DiceDB database
                                  running at {server_url}, use
                                  this for url.""",
                  mcp_servers=[mcp_server],)
    result = await Runner.run(starting_agent=agent, input=prompt)
    print(result.final_output)


async def main():
    openai.api_key = os.getenv("OPENAI_API_KEY")

    prompt = "Can you change the value of the 'name' key to 'Rachel Green'?"
    server_url = "localhost:7379"

    async with MCPServerStdio(
        cache_tools_list=True,
        params={"command": "path/to/dicedb-mcp", "args": [""]},
    ) as server:
        with trace(workflow_name="DiceDB MCP"):
            await run(server, prompt, server_url)


if __name__ == "__main__":
    asyncio.run(main())

可用工具

ping

向 DiceDB 服务发送 Ping，以检查连接情况。

echo

通过 DiceDB 服务回显一条消息。

get

根据键从 DiceDB 获取一个值。

set

在 DiceDB 中设置一个键值对。

del

删除 DiceDB 中的一个或多个键。

incr

将键的整数值递增 1。

decr

将键的整数值递减 1。

开发

Fork 并克隆此仓库：

git clone https://github.com/username/dicedb-mcp.git

切换到该目录：

cd dicedb-mcp

安装依赖项：

make deps

构建项目：

make build

更新 MCP 服务配置，使其指向本地构建版本：

{
    "mcpServers": {
        "dicedb-mcp": {
            "command": "/path/to/dicedb-mcp/dist/dicedb-mcp"
        }
    }
}

许可证

MIT 许可证