DiceDB MCP

DiceDB MCP

AI アプリケーション（ホスト／クライアント）と DiceDB データベースサーバー間のやり取りを可能にする、DiceDB 向けの Model Context Protocol（MCP） サーバー実装です。

DiceDB との通信には、DiceDB Go SDK を使用しています。

実際の動作については、デモ動画をご覧ください！

機能

• DiceDB に PING を送信し、接続を確認します。
• DiceDB 経由でメッセージを ECHO します。
• キーを指定して、DiceDB から値を GET します。
• DiceDB にキーと値のペアを SET します。
• DiceDB から 1 つ以上のキーを 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 での使用

以下の例は、OpenAI Agents SDK で dicedb-mcp サーバーを使用する方法を示しています：

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 サーバー経由でメッセージを ECHO します。

get

キーを指定して、DiceDB から値を取得します。

set

DiceDB にキーと値のペアを設定します。

del

DiceDB から 1 つ以上のキーを削除します。

incr

キーの整数値を 1 増やします。

decr

キーの整数値を 1 減らします。

開発

リポジトリをフォークしてクローンします：

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 ライセンス