Dicedb MCP

🚀 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.