AI导哈

JSON文档数据库管理协议

为AI代理提供通过自然语言创建、查询和管理JSON文档的托管数据库服务

  • by JsonDBCloud
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jsondbcloud/mcp

使用说明

@jsondb云/mcp

官方MCP（模型上下文协议）服务器 jsondb.cloud --托管JSON文档数据库。允许AI代理通过自然语言创建、查询和管理文档。

安装

npm install @jsondb-cloud/mcp

用法

配置后，询问您的AI助手：

列出我数据库中的所有收藏

在“用户”中创建一个名为“Alice”、角色为“admin”的文档

查找角色为“admin”的所有用户

在“订单”中显示文档abc123的版本历史记录

在document.created上触发的“订单”上设置一个webhook

配置

您需要一个jsondb.cloud API密钥。从你的 仪表盘.

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jsondb": {
      "command": "npx",
      "args": ["-y", "@jsondb-cloud/mcp"],
      "env": {
        "JSONDB_API_KEY": "jdb_sk_live_..."
      }
    }
  }
}

克劳德代码

claude mcp add jsondb \
  -e JSONDB_API_KEY=jdb_sk_live_... \
  -- npx -y @jsondb-cloud/mcp

光标

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "jsondb": {
      "command": "npx",
      "args": ["-y", "@jsondb-cloud/mcp"],
      "env": {
        "JSONDB_API_KEY": "jdb_sk_live_..."
      }
    }
  }
}

环境变量

变量 必填 默认 描述
JSONDB_API_KEY 是 - neneneba API密钥(jdb_sk_live_... 或 jdb_sk_test_...)
JSONDB_PROJECT 没有 v1 项目命名空间
JSONDB_BASE_URL 没有 https://api.jsondb.cloud API基本URL
JSONDB_MCP_TRANSPORT 没有 stdio 运输类型： stdio 或 http
JSONDB_MCP_PORT 没有 3100 HTTP服务器端口（仅与 http 运输）
JSONDB_MCP_HOST 没有 127.0.0.1 HTTP绑定地址（仅与 http 运输）

工具

文件

工具 说明
create_document 在集合中创建新文档
get_document 按ID读取单个文档
list_documents 列出具有过滤、排序和分页功能的文档
update_document 完全替换文档
patch_document 部分更新文档（合并补丁）
delete_document 按ID删除文档
count_documents 统计与可选筛选器匹配的文档
json_patch_document 应用RFC 6902 JSON补丁操作

集合

工具 说明
list_collections 列出当前项目中的所有集合
search_documents 使用高级过滤器搜索(eq, gt, contains, in等等）
import_documents 批量导入并解决冲突(fail, skip, overwrite)
export_collection 将所有文档导出为JSON格式

模式

工具 说明
get_schema 获取集合的JSON模式
set_schema 设置JSON模式以强制文档结构
remove_schema 从集合中删除架构验证
validate_document 模拟运行根据模式验证文档

版本

工具 说明
list_versions 列出文档的所有存储版本
get_version 检索特定版本快照
restore_version 将文档还原到以前的版本
diff_versions 使用结构化差异比较两个版本

网络钩子

工具 说明
create_webhook 为收集事件注册webhook
list_webhooks 列出集合的所有Webhook
get_webhook 获取webhook详细信息和最近的交付历史记录
update_webhook 更新webhook URL、事件或状态
delete_webhook 删除webhook
test_webhook 发送测试事件以验证交付

矢量

工具 说明
semantic_search 使用自然语言语义相似度和相关性得分搜索文档
store_with_embedding 存储文档并自动生成用于语义搜索的向量嵌入

生成嵌入 由jsondb.cloud后端异步执行 使用 奥拉玛 (nomic-embed-text768维）。MCP服务器委托给REST API-不需要本地嵌入模型或API密钥。

HTTP传输

默认情况下，服务器使用 标准 传输（适用于克劳德桌面、光标等）。要作为HTTP服务器运行，请设置：

JSONDB_MCP_TRANSPORT=http JSONDB_API_KEY=jdb_sk_live_... npx @jsondb-cloud/mcp

这将启动一个无状态的Streamable HTTP服务器，创建一个新的 McpServer +每个请求的传输（不需要会话关联）。终点：

方法 路径 描述
POST /mcp MCP JSON-RPC请求
GET /mcp 服务器通知的SSE流
DELETE /mcp 会话终止
GET /health 健康检查（退货 {"status":"ok"})

使用配置主机和端口 JSONDB_MCP_HOST 和 JSONDB_MCP_PORT （默认值： 127.0.0.1:3100).

文档

完整文档请访问 Jsondb.cloud/docs.

相关套餐

包装 描述
@jsondb云/客户端 JavaScript/TypeScript SDK
@jsondb云/mcp 用于AI代理的MCP服务器
@jsondb云/cli CLI工具
jsondb云 （PyPI） Python SDK

许可证

麻省理工学院

相关 MCP