DKG 메모리 MCP 서버

OriginTrail DKG V10 3계층 검증 가능 메모리(작업 메모리 / 공유 메모리 / 검증 가능 메모리)를 표준 MCP 도구로 노출하는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Cursor, Claude Code 또는 일반 MCP 에이전트 등 MCP를 지원하는 모든 클라이언트에 마운트하여, 맞춤형 HTTP 연결 없이 DKG 메모리를 읽고, 쓰고, 공유하고, 조회할 수 있습니다.

본 프로젝트는 DKG v10 통합 요청(Round 1: 작업 메모리 및 공유 메모리) 에 제출된 결과물입니다. 전송 계층에 독립적인 도구 레이어로서, 형제 프로젝트인 OpenClaw 메모리 큐레이터 데몬(OpenClaw 전용)과는 구별됩니다.

도구

Round 1 범위는 작업 메모리 + 공유 메모리만 해당합니다. vm/publish 도구는 없습니다(검증 가능 메모리는 이후 라운드에서 제공되며, 명시적인 인간 승인 게시 절차가 필요합니다). 또한 UI 추천/투표 도구도 없습니다(현상금 규정상 허용되지 않음).

Related MCP server: MemoryIQ

설치

npm install -g dkg-memory-mcp

실행 중인 DKG V10 노드(기본값 http://127.0.0.1:9200)와 ~/.dkg/auth.token 경로의 인증 토큰이 필요합니다(2행; #로 시작하는 줄은 무시됨).

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "dkg-memory": {
      "command": "dkg-memory-mcp",
      "args": []
    }
  }
}

Cursor / Claude Code

dkg-memory-mcp 명령으로 MCP 서버를 등록합니다(stdio 전송).

환경 변수(선택 사항)

개발

npm install
node --test test/*.test.js   # unit tests
node src/server.js           # run the stdio server

실시간 스모크 테스트

DKG V10 노드(Base Sepolia 테스트넷)에 대해 종단 간 검증 완료: KA 생성 → 작업 메모리에 쿼드 쓰기 → SPARQL 회수 → 피어 ID, 지갑, 기본 에이전트 주소에 걸쳐 3개 바인딩 반환 확인.

라이선스

Apache-2.0

검증 예시(2026-08-22)

stdio MCP 프로토콜을 통해 로컬 DKG 노드(v10.0.13, 테스트넷)에 대한 실제 MCP 왕복 테스트 수행:

// tools/call dkg_write_memory
{
  "kaName": "hermes-audit-manic",
  "subject": "urn:dkg:hermes:demo:manic-deposit",
  "triples": [
    {"predicate": "http://127.0.0.1:7878/actionType", "object": "deposit"},
    {"predicate": "http://127.0.0.1:7878/chain", "object": "solana"},
    {"predicate": "http://127.0.0.1:7878/outcome", "object": "success"}
  ]
}
// -> Created Knowledge Asset "hermes-audit-manic-1787398447058" with 4 quad(s)
//    assertionUri: did:dkg:.../_working_memory/.../269
//    status: wm-sealed | merkleRoot: 0x8aa210f8... | written: 4

// tools/call dkg_query_memory (SPARQL)
{"query": "SELECT ?s ?p ?o WHERE { ?s <http://127.0.0.1:7878/actionType> \"deposit\" . ?s ?p ?o }", "view": "working"}
// -> returns the deposited action quads (incl. records written by sibling tools)

쓰기 작업은 작업 메모리에 시일(EIP-712 시일, 머클 루트 기반)로 확정되었고, SPARQL 쿼리는 형제 프로젝트 dkg-hermes-bridge가 기록한 레코드를 포함하여 이를 다시 회수했습니다. 이는 공유 DKG 서브스트레이트에서의 교차 도구 가시성을 입증합니다.