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 个人访问令牌。