Model Context Protocol and Fireproof Demo: JSON Document Collection Server

Model Context Protocol and Fireproof Demo: JSON Document Collection Server

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

Overview

基本能力

产品定位

该服务是一个 JSON 文档数据库管理工具,专为 AI 系统(如 Claude Desktop)设计,用于存储和管理结构化数据。

核心功能

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

适用场景

  • 在 AI 系统中存储和管理结构化数据
  • 需要快速创建和操作多个 JSON 数据库的场景
  • 需要与他人共享数据库内容的场景

工具列表

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

常见问题解答

  1. 如何创建新的 JSON 文档数据库? 通过发送命令如 create a json document database named <database_name> 来创建。
  2. 如何同步数据库到云端? 使用 sync <database_name> to cloud 命令。
  3. 如何删除所有数据库? 使用 delete all databases 命令。

使用教程

使用依赖

  • 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

配置 Claude Desktop

在 MacOS 上编辑配置文件: ~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上编辑配置文件: %APPDATA%/Claude/claude_desktop_config.json

添加以下配置:

{
  "mcpServers": {
    "json-db-collections": {
      "command": "<base-dir>/mcp-json-db-collection-server/build/index.js"
    }
  }
}

许可证

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