Model Context Protocol and Fireproof Demo: JSON Document Collection Server

Model Context Protocol and Fireproof Demo: JSON Document Collection Server

site icon
2024.12.30 0
JavaScriptJSON 文档数据库数据管理云同步数据库开发效率
mcp-json-db-collection-server 是一个基于 Model Context Protocol 的 JSON 文档数据库集合服务,使用 Fireproof 数据库实现。它允许创建多个 JSON 文档数据库,并支持基本的 CRUD 操作(创建、读取、更新、删除)以及按字段排序查询文档。此外,该服务还支持通过 Fireproof Cloud 服务与他人共享数据库。
View on GitHub

Overview

基本能力

产品定位

mcp-json-db-collection-server 是一个 JSON 文档数据库集合服务,旨在为 AI 系统(如 Claude Desktop)提供代码和数据的插件支持。

核心功能

  • 创建多个 JSON 文档数据库(使用 Fireproof 实现)
  • 实现基本的 CRUD 操作(创建、读取、更新、删除)
  • 支持按字段排序查询文档
  • 通过 Fireproof Cloud 服务与他人共享数据库

适用场景

  • 在 AI 系统中管理和查询 JSON 文档数据
  • 创建和管理多个主题的数据库(如元素、食谱成分、马匹品种等)
  • 通过云服务共享数据库

工具列表

  • Fireproof 数据库:提供 JSON 文档存储和查询功能
  • Fireproof Cloud 服务:支持数据库的云同步和共享

常见问题解答

  • 如何创建新的 JSON 文档数据库? 使用命令 create a json document database named <database_name>
  • 如何添加文档到数据库? 使用命令 add <content> as individual docs
  • 如何查询数据库中的文档? 使用命令 show docsshow <content> as table
  • 如何同步数据库到云端? 使用命令 sync <database_name> to cloud
  • 如何删除数据库? 使用命令 delete all databasesdelete <database_name>

使用教程

使用依赖

  • Node.js 环境
  • npm 或 pnpm 包管理器

安装教程

  1. 克隆项目仓库
  2. 安装依赖: bash npm install # 或 pnpm install
  3. 构建项目: bash npm build # 或 pnpm build

调试方式

  1. 运行检查器: bash pnpm run inspector
  2. 重置环境(如果需要): bash rm -rf ~/.fireproof /tmp/dist

  3. 配置 Claude Desktop(可选): 在 ~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%/Claude/claude_desktop_config.json 中添加以下配置: json { "mcpServers": { "json-db-collections": { "command": "<base-dir>/mcp-json-db-collection-server/build/index.js" } } }

许可证

该项目遵循 MIT or Apache 2 开源许可条款。