Model Context Protocol 和 Fireproof 演示：JSON 文档集合服务器

❤️

这是一个如何在 Model Context Protocol 服务器（用于将代码和数据插入到像 Claude Desktop 这样的 A.I. 系统）中使用 Fireproof 数据库的示例。

该服务器：

• 允许创建多个“JSON 文档数据库”（使用 Fireproof 实现）
• 在任何数据库内实现基本的 CRUD 操作（创建、读取、更新、删除），并能够按任意字段对文档进行查询排序。
• 允许通过 Fireproof Cloud 服务和仪表板与他人共享任何数据库

先前的工作：这是基于 https://github.com/fireproof-storage/mcp-database-server 的 - 它增加了多个数据库以及同步到云端的功能。

运行服务器

首先，构建它：

npm install
npm build

要与 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"
    }
  }
}

Claude Desktop 聊天会话示例

这里是一个使用 Claude Desktop 创建 3 个文档数据库并将它们同步到云端的示例会话：

1. 聊天会话：元素数据库

人类 (2024年12月29日, 下午03:59)

创建一个名为 elements 的 JSON 文档数据库

助手 (2024年12月29日, 下午04:00)

我将帮助你创建一个名为 "elements" 的 JSON 文档数据库。

数据库已成功创建。现在你可以使用此数据库来存储和管理 JSON 文档。你想向其中添加一些文档吗？

人类 (2024年12月29日, 下午04:00)

从周期表中添加稀有气体作为单独的文档

助手 (2024年12月29日, 下午04:00)

我将帮助你把稀有气体作为单独的文档添加到 elements 数据库中。我会为每种稀有气体包括关键属性。

我已经将所有七种稀有气体（氦、氖、氩、氪、氙、氡和 Oganesson）添加到了数据库中。对于每个元素，我包含了以下信息：

• 名称和符号
• 原子序数和质量
• 周期、族和区
• 电子构型
• 熔点和沸点（以开尔文为单位）
• 密度（以 g/cm³ 为单位）

请注意，对于 Oganesson，某些物理属性被标记为 null，因为它是半衰期非常短的人造元素，其属性尚未通过实验很好地确定。

你想从数据库中查询这些稀有气体的特定信息吗？

人类 (2024年12月29日, 下午04:01)

显示文档

助手 (2024年12月29日, 下午04:01)

我将按原子序数排序从 elements 数据库中查询所有文档。

以下是数据库中的所有稀有气体，按照原子序数从高到低排列：

1. 钋 (Og) - 元素 118
2. 氡 (Rn) - 元素 86
3. 氙 (Xe) - 元素 54
4. 氪 (Kr) - 元素 36
5. 氩 (Ar) - 元素 18
6. 氖 (Ne) - 元素 10
7. 氦 (He) - 元素 2

每份文档都包含了该元素的详细信息，包括其原子质量、密度、熔点和沸点（如果已知）以及电子排布。您想检查这些元素的特定属性或比较它们的某些方面吗？

2. 聊天会话：饼干原料数据库

人类 (2024年12月29日, 下午04:01)

创建一个名为cookie_ingredients的JSON文档数据库

助手 (2024年12月29日, 下午04:01)

我将创建一个新的名为"cookie_ingredients"的JSON文档数据库。

数据库已成功创建。您想要向其中添加任何原料吗？

人类 (2024年12月29日, 下午04:02)

从巧克力芯片饼干食谱中添加原料作为单独的文档

助手 (2024年12月29日, 下午04:02)

我会将巧克力芯片饼干的常见原料作为单独的文档添加进去，包括它们的标准量度和特性。

我已经为经典巧克力芯片饼干配方添加了所有必要的原料。对于每种原料，我包括了：

• 名称及用量
• 单位
• 类型（干性、湿性、膨松剂等）
• 在食谱中的作用
• 可能的替代品
• 重量测量
• 使用时的重要注意事项

您是否希望从数据库中查询这些原料的具体信息？

人类 (2024年12月29日, 下午04:02)

以表格形式显示原料

助手 (2024年12月29日, 下午04:03)

我将以Markdown表格的形式查询并展示这些原料。

原料	用量	单位	类型	用途	重量/单位
中筋面粉	2¼	杯	干性	结构	120g/杯
无盐黄油	1	杯	脂肪	纹理和风味	227g/杯
细砂糖	¾	杯	甜味剂	甜度和纹理	200g/杯
黄糖	¾	杯	甜味剂	保湿和风味	220g/杯
大鸡蛋	2	整个	绑定剂	结构和丰富性	每个50g
香草精	1	茶匙	调味	增强风味	5g/茶匙
盐	1	茶匙	调味	增强风味	6g/茶匙
小苏打	1	茶匙	膨松剂	上升和扩展	4.8g/茶匙
巧克力豆	2	杯	混合物	风味和纹理	170g/杯

我根据类型组织了这些原料，并包括了它们的用量、单位、用途和重量测量。您是否希望查看有关特定原料的额外细节？

3. 聊天会话：马品种数据库

人类 (2024年12月29日, 下午04:03)

创建一个新的名为horse_breeds的JSON文档数据库

助手 (2024年12月29日, 下午04:03)

我将为马品种创建一个新的JSON文档数据库。

数据库已成功创建。您想要向其中添加一些马品种吗？

人类 (2024年12月29日, 下午04:03)

是的

助手 (2024年12月29日, 下午04:04)

我将添加几种流行的马品种，包括它们的关键特征、起源和典型用途。

我已经向数据库中添加了六种独特的马品种：

1. 阿拉伯马 - 以耐力和精致著称
2. 纯血马 - 赛马和运动能力闻名
3. 克莱兹代尔马 - 强壮的挽马
4. 夸特马 - 美国多用途的工作马
5. 弗里斯兰马 - 来自荷兰的优雅黑马
6. 阿帕卢萨马 - 以其斑点图案和美洲原住民传统而知名

每个条目包含以下信息：

• 起源和类型
• 身高范围（以“手”为单位 - 1手 = 4英寸）
• 常见颜色
• 物理特征
• 典型用途
• 性情
• 显著特征

您是否希望以特定方式查看这些信息或了解更多关于某个特定品种的信息？

4. 聊天会话：同步到云端

human (2024年12月29日, 下午04:04)

列出 JSON 文档数据库

assistant (2024年12月29日, 下午04:04)

我将列出所有已创建的JSON文档数据库。

我们有三个JSON文档数据库：

1. horse_breeds
2. elements
3. cookie_ingredients

每个数据库都包含了与其特定主题相关联的文档：

• horse_breeds 包含不同马品种的信息
• elements 包含关于稀有气体的数据
• cookie_ingredients 包含巧克力芯片饼干成分的细节

您想要从这些数据库中查询任何具体信息吗？

human (2024年12月29日, 下午04:04)

将 horse_breeds 同步到云端

assistant (2024年12月29日, 下午04:04)

我将帮助您连接 horse_breeds 数据库至云同步服务。

horse_breeds 数据库已成功连接到云端。您可以使用上方提供的URL访问仪表板。这将允许您通过云界面查看和管理您的马品种数据。您还需要将其他数据库同步到云端吗？

human (2024年12月29日, 下午04:05)

显示 URL

human (2024年12月29日, 下午04:05)

将 elements 数据库同步到云端

assistant (2024年12月29日, 下午04:05)

我将连接 elements 数据库到云同步服务。

elements 数据库已成功连接到云端。

您也想同步 cookie_ingredients 数据库吗？

human (2024年12月29日, 下午04:05)

是的

assistant (2024年12月29日, 下午04:05)

我将连接 cookie_ingredients 数据库到云同步服务。

现在，所有三个数据库（horse_breeds、elements 和 cookie_ingredients）都已同步到云端，并且可以通过各自的仪表板 URL 访问。

5. 聊天会话：清理

human (2024年12月29日 下午04:06)

删除所有数据库

assistant (2024年12月29日 下午04:06)

我将帮助你删除所有三个数据库。

所有三个数据库均已成功删除：

1. horse_breeds
2. elements
3. cookie_ingredients

让我确认一下它们是否都已经不在了。

确认 - 系统中没有剩余的数据库。你想创建新的数据库吗？

转换为 Markdown 格式感谢于: https://simonwillison.net/2024/Aug/8/convert-claude-json-to-markdown/

未来开发想法

• 提示词
• 资源
• 多用户权限
• 索引
• 使用 Firebase npm 库从 Claude Desktop 生成静态网站

开发

pnpm install
pnpm build
pnpm run inspector
# To reset, do: rm -rf ~/.fireproof /tmp/dist

~/Library/Application\ Support/Claude/claude_desktop_config.json:

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

许可证

MIT 或 Apache 2