DenoKV MCP Server

DenoKV MCP サーバー

Deno KV インスタンスとチャットするための MCP サーバーです。

MCP クライアントでの使用方法

Deno（推奨）

このサーバーを Claude Desktop や Cursor などの MCP クライアントと統合する最も簡単な方法は、公開済みの JSR パッケージを使用することです。次のように MCP クライアントを設定してください。

{
  "mcpServers": {
    "denokv": {
      "command": "deno",
      "args": [
        "run",
        "--unstable-kv",
        "--allow-env",
        "--allow-net",
        "--allow-read",
        "--allow-write",
        "--allow-run",
        "jsr:@joshuayoes/deno-kv-mcp"
      ],
      "env": {
        "DENO_KV_PATH": "path/to/your/kv.db OR https://api.deno.com/databases/<UUID>/connect",
        "DENO_KV_ACCESS_TOKEN": "<YOUR_DENO_DEPLOY_ACCESS_TOKEN>" // Only needed for remote DB
      }
    }
  }
}

env の値は、使用環境に合わせて置き換えてください。

Node

次のことを確認したうえで、

• Deno には Node で動作する KV の公式クライアントライブラリがあります
• Deno には Node との互換性レイヤーがあります。
• jsr パッケージは npx ではネイティブに動作しませんが、xjsr npm パッケージのおかげで、npx と node を使って jsr パッケージを実行できます。

Node で実行できます。

{
  "mcpServers": {
    "denokv": {
      "command": "npx",
      "args": ["xjsr", "@joshuayoes/deno-kv-mcp@latest"],
      "env": {
        "DENO_KV_PATH": "path/to/your/kv.db OR https://api.deno.com/databases/<UUID>/connect",
        "DENO_KV_ACCESS_TOKEN": "<YOUR_DENO_DEPLOY_ACCESS_TOKEN>" // Only needed for remote DB
      }
    }
  }
}

env の値は、使用環境に合わせて置き換えてください。

さらに自由に試してみたい場合は、npx を bunx に置き換えてください。

利用可能なツール

このサーバーでは、次のツールを利用できます。

• set：Deno KV ストアにキーと値のペアを設定します。
  • key（文字列の配列）：設定するキーです。
  • value（文字列）：設定する値です（JSON 文字列）。
  • expireIn（数値、省略可能）：キーの有効期間（TTL、ミリ秒）です。
• get：Deno KV ストアからキーに対応する値を取得します。
  • key（文字列の配列）：取得するキーです。
  • consistency（列挙型："strong" | "eventual"、省略可能）：読み取り時の一貫性レベルです。
• delete：Deno KV ストアからキーと値のペアを削除します。
  • key（文字列の配列）：削除するキーです。
• getMany：Deno KV ストアから複数のキーに対応する値を取得します。
  • keys（文字列配列の配列）：取得するキーです。
  • consistency（列挙型："strong" | "eventual"、省略可能）：読み取り時の一貫性レベルです。
• list：セレクターに基づいてキーと値のペアを一覧表示します。
  • prefix（文字列の配列、省略可能）：一覧表示するキーのプレフィックスです（例：["users"]）。
  • start（文字列の配列、省略可能）：範囲クエリの開始キーです（例：["orders", "2023"]）。
  • end（文字列の配列、省略可能）：範囲クエリの終了キーです（例：["orders", "2024"]）。
  • limit（正の整数、省略可能）：返すエントリの最大数です。
  • consistency（列挙型："strong" | "eventual"、省略可能）：一覧表示操作の一貫性レベルです。
  • batchSize（正の整数、省略可能）：内部でバッチごとに取得するエントリ数です。
  • reverse（ブール値、省略可能）：エントリの順序を逆にするかどうかを指定します。
  • 注： prefix、start、または（start と end）のパラメーターを指定する必要があります。end を指定するには、start または prefix が必要です。

ローカル開発環境のセットアップ

開発やテストなどのために、このリポジトリをローカルにクローンしてサーバーを実行する場合は、代わりに次の設定を使用してください。

Deno

{
  "mcpServers": {
    "denokv": {
      "command": "deno",
      "args": [
        "run",
        "--unstable-kv",
        "--allow-env",
        "--allow-net",
        "--allow-read",
        "--allow-write",
        "--allow-run",
        "/path/to/your/mcp-deno-kv/index.ts" // Replace with the actual path to index.ts
      ],
      "env": {
        "DENO_KV_PATH": "path/to/your/kv.db OR https://api.deno.com/databases/<UUID>/connect",
        "DENO_KV_ACCESS_TOKEN": "<YOUR_DENO_DEPLOY_ACCESS_TOKEN>" // Only needed for remote DB
      }
    }
  }
}

/path/to/your/mcp-deno-kv/index.ts と env の値は、使用環境に合わせて置き換えてください。

Node

Node（>=v22.7.0）を使えば、ビルド手順なしでサーバーを直接実行することもできます。

先に deno install を実行して node_modules フォルダーを追加する必要がある場合があります。

{
  "mcpServers": {
    "denokv": {
      "command": "node",
      "args": [
        "--experimental-transform-types",
        "/path/to/your/mcp-deno-kv/index.ts" // Replace with the actual path to index.ts
      ],
      "env": {
        "DENO_KV_PATH": "path/to/your/kv.db OR https://api.deno.com/databases/<UUID>/connect",
        "DENO_KV_ACCESS_TOKEN": "<YOUR_DENO_DEPLOY_ACCESS_TOKEN>" // Only needed for remote DB
      }
    }
  }
}

/path/to/your/mcp-deno-kv/index.ts と env の値は、使用環境に合わせて置き換えてください。

さらに自由に試してみたい場合は、npx を bunx に置き換えてください。

環境変数

このサーバーでは、次の環境変数を設定する必要があります。

• DENO_KV_PATH：Deno KV データベースへのパスを指定します。
  • ローカルデータベースの場合、ファイルパスを指定します（例：./my-kv.db）。
  • リモートの Deno Deploy データベースの場合、接続 URL を指定します（例：https://api.deno.com/databases/<UUID>/connect）。
• DENO_KV_ACCESS_TOKEN：DENO_KV_PATH がリモートの Deno Deploy データベースを指している場合にのみ必要です。Deno Deploy の個人用アクセストークンを指定します。