Dicedb MCP

🚀 DiceDB MCP サーバー実装

このプロジェクトは、AI アプリケーション（ホスト/クライアント）と DiceDB データベースサーバー間のやり取りを可能にする モデルコンテキストプロトコル (MCP) のサーバー実装です。この実装では、DiceDB Go SDK を使用して DiceDB と通信します。デモビデオ を見ると、動作を確認できます！

🚀 クイックスタート

このサーバー実装を使用することで、AI アプリケーションと DiceDB データベースサーバー間のやり取りが可能になります。以下のセクションでは、インストール方法や使用方法を説明します。

✨ 主な機能

• DiceDB への PING で接続性を確認します。
• DiceDB を介してメッセージをエコーします。
• キーに基づいて DiceDB から値を取得します。
• DiceDB でキーと値のペアを設定します。
• DiceDB から 1 つまたは複数のキーの値を削除します。
• 特定のキーの整数値を 1 増やします。
• 特定のキーの整数値を 1 減らします。

📦 インストール

バイナリファイルのダウンロード

"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 から 1 つまたは複数のキーの値を削除します。
• increment - 特定のキーの整数値を 1 増やします。
• decrement - 特定のキーの整数値を 1 減らします。

🔧 開発

リポジトリのクローン

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.