다이스DB MCP

DiceDB에 대한 MCP(Model Context Protocol) 서버 구현으로 AI 애플리케이션(호스트/클라이언트)과 DiceDB 데이터베이스 서버 간의 상호작용이 가능합니다.

이 구현에서는 DiceDB Go SDK를 사용하여 DiceDB와 통신합니다.

실제 작동 모습을 보려면 데모 영상을 확인하세요!

특징

PING DiceDB를 사용하여 연결 상태를 확인하세요.
DiceDB를 통해 메시지를 에코합니다.
키를 통해 DiceDB에서 값을 가져옵니다.
DiceDB에서 키-값 쌍을 설정합니다.
DiceDB에서 하나 이상의 키를 삭제합니다.
키의 정수 값을 1만큼 INCR합니다.
키의 정수 값을 1만큼 DECR합니다.

설치

바이너리 다운로드

"릴리스" 페이지에서 운영 체제와 프로세서 아키텍처에 적합한 바이너리를 다운로드 하여 사용할 수 있습니다.

Go를 통해 설치

필수 조건:

1.24 이상으로 가세요

지엑스피1

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())

사용 가능한 도구

핑

DiceDB 서버에 ping을 보내 연결성을 확인합니다.

에코

DiceDB 서버를 통해 메시지를 에코합니다.

얻다

키를 사용하여 DiceDB에서 값을 검색합니다.

세트

DiceDB에서 키-값 쌍을 설정합니다.

델

DiceDB에서 하나 이상의 키를 삭제합니다.

증가

키의 정수 값을 1만큼 증가시킵니다.

감소하다

키의 정수 값을 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 라이센스

Integrations