Dynobase

dynobase-mcp

此软件包可将只能启动 stdio MCP 服务的 AI 工具（例如 Claude Desktop、Codex 和 Windsurf）连接到 Dynobase 内置的 MCP 服务。Dynobase 是 Amazon DynamoDB 的桌面客户端。

Dynobase 3.0 及更高版本可在你的机器上运行 Model Context Protocol 服务。AI 工具可以通过该服务列出你的表、读取表架构，并使用 Dynobase 已加载的 AWS 配置文件查询数据。除非你允许写入，否则服务仅支持读取。Claude Code 和 Cursor 可以直接通过 HTTP 连接。

此软件包可将其他所有客户端连接到该服务。它从 stdin 读取 MCP 消息，将消息转发给 Dynobase，并将响应写入 stdout。它没有依赖项。

此桥接工具采用 MIT 许可证。Dynobase 本身是付费应用，提供 7 天免费试用。

要求

• Dynobase 3.0 或更高版本，已打开，并已启用 Settings → AI → MCP server
• Node.js 18 或更高版本。Claude Desktop 扩展不需要安装 Node.js，因为 Claude Desktop 在 macOS 和 Windows 上自带 Node.js。

设置

在 Dynobase 中启用 MCP 服务，然后将桥接工具添加到客户端。桥接工具会从 Dynobase 设置中读取端口和令牌，因此客户端配置无需包含令牌。

Claude Desktop 扩展：从最新版本下载 .mcpb 文件并打开。Claude Desktop 会显示安装对话框。将令牌和 URL 字段留空。

Claude Desktop（手动配置）、Windsurf 以及其他使用 mcpServers 文件的客户端

{
  "mcpServers": {
    "dynobase": {
      "command": "npx",
      "args": ["-y", "github:Dynobase/dynobase-mcp"]
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.dynobase]
command = "npx"
args = ["-y", "github:Dynobase/dynobase-mcp"]

Claude Code 也可以使用此桥接工具：

claude mcp add dynobase -- npx -y github:Dynobase/dynobase-mcp

Claude Code 和 Cursor 也可以跳过桥接工具，直接通过 HTTP 连接到 Dynobase。Dynobase 的设置部分提供了相应配置片段。

要在终端中测试连接：

npx -y github:Dynobase/dynobase-mcp --check

选项

标志	环境变量	默认值
--url <url>	DYNOBASE_MCP_URL	http://127.0.0.1:<port>/mcp，使用 Dynobase 中保存的端口（除非你修改过，否则为 41961）
--token <token>	DYNOBASE_MCP_TOKEN	Dynobase 设置中保存的令牌

标志的优先级高于环境变量，环境变量的优先级高于 Dynobase 设置。

Dynobase 将设置保存在 ~/.dynobase 中；如果设置了 DYNOBASE_DATA_DIR，则保存在该目录中。如果桥接工具无法读取该文件夹（例如客户端以其他用户身份运行），请显式传入令牌。

AI 工具可以执行的操作

以下读取工具始终可用：

工具	功能
list_profiles	列出已加载的配置文件及其区域和表名
list_tables	列出一个配置文件中的表名
describe_table	返回完整的 DescribeTable 输出和 TTL
scan	返回一页 Scan 结果
query	返回一页 Query 结果
get_item	根据主键返回一个项目
partiql	执行一条 PartiQL 语句；除非允许写入，否则仅支持 SELECT
explain_query	说明键条件会使用哪个索引，以及执行的是 Query 还是 Scan

写入工具包括 put_item、update_item、delete_item、batch_write 和 PartiQL 写入。只有在 Dynobase 中启用 Allow writes 后，这些工具才能使用。Dynobase 会将 MCP 客户端执行的每次写入记录在项目的 History 中，方便你还原。PartiQL 写入例外，无法还原。

每次调用最多返回约 1 MB 的项目，并会在 60 秒后超时。工具来自你安装的 Dynobase 版本，而非此软件包。

安全性

• Dynobase 的 MCP 服务仅监听 127.0.0.1。它会拒绝 Host 标头不是环回地址名称的请求。
• 每个请求都需要 bearer 令牌。桥接工具从你的设置文件夹读取令牌，仅将其发送到配置的 URL，并且绝不会记录令牌。
• 除非你允许写入，否则服务仅支持读取。
• 你的 AWS 凭证保留在 Dynobase 中。客户端只能看到工具结果。

故障排除

npx -y github:Dynobase/dynobase-mcp --check 会报告检查结果。桥接程序将日志写入 stderr，大多数客户端会在其 MCP 日志中显示这些日志。

• “无法连接到 Dynobase”：打开 Dynobase，并检查 Settings → AI → MCP server 是否已开启。如果你更改了端口，桥接程序会从设置中读取新端口，除非你设置了 --url 或 DYNOBASE_MCP_URL。
• “Dynobase 中的 MCP 服务已关闭”：在 Settings → AI → MCP server 中将其开启。
• “Dynobase 拒绝了令牌”：令牌已重新生成。更新 --token 或 DYNOBASE_MCP_TOKEN，或者移除它们，让桥接程序从设置中读取当前令牌。

工作原理

stdin 中的每一行都是一条 JSON-RPC 消息。桥接程序会使用 Authorization: Bearer <token> 将其 POST 到 Dynobase 的 Streamable HTTP 端点。随后，它会将响应中的每条 JSON-RPC 消息写入 stdout，每行一条。响应可以是 JSON，也可以是事件流，并且请求会并行运行。

有些错误会在 Dynobase 响应前发生，例如连接被拒绝或令牌被拒绝。桥接程序会将这些错误作为 JSON-RPC 错误返回，并说明如何修复。

许可证

MIT。Dynobase 是独立的商业产品：https://dynobase.dev