模型上下文协议和 Fireproof 演示：JSON 文档集合服务器

<h1> <img alt="Fireproof" src="./images/fp-logo.svg" height="30pt"> ❤️ <img alt="MCP" src="./images/mcp-light.png" height="30pt"> </h1>

这是一个如何在 模型上下文协议 服务器中使用 Fireproof 数据库的示例（用于将代码和数据插入到 A.I. 系统，例如 Claude Desktop）。

此服务器：

• 允许创建多个“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. 聊天会话：元素数据库

human (2024 年 12 月 29 日，下午 03:59)

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

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

我将帮助您创建一个名为“elements”的 JSON 文档数据库。

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

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

将元素周期表中的稀有气体添加为单独的文档

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

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

我已经将所有七种稀有气体（氦、氖、氩、氪、氙、氡和 Og）添加到数据库。对于每种元素，我包括：

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

请注意，对于 Og，某些物理属性标记为 null，因为它是一种半衰期非常短的合成元素，并且其属性尚未通过实验充分确定。

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

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

显示文档

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

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

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

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

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

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

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

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

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

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

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

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

将巧克力曲奇食谱中的配料添加为单独的文档

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

我将添加巧克力曲奇的常见配料作为单独的文档，其中包含它们的典型计量和属性。

我已经添加了经典巧克力曲奇食谱的所有基本配料。对于每种配料，我包括：

• 名称和数量
• 计量单位
• 类型（干、湿、膨松剂等）
• 在食谱中的用途
• 可能的替代品
• 重量计量
• 关于使用的重要说明

您想从数据库中查询有关这些配料的任何特定信息吗？

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

以表格形式显示配料

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

我将查询配料并将其格式化为 markdown 表格。

配料	数量	单位	类型	用途	重量/单位
通用面粉	2¼	杯	干	结构	120 克/杯
无盐黄油	1	杯	脂肪	质地和风味	227 克/杯
砂糖	¾	杯	甜味剂	甜度和质地	200 克/杯
红糖	¾	杯	甜味剂	湿度和风味	220 克/杯
大鸡蛋	2	个	粘合剂	结构和浓郁度	50 克/个
香草精	1	茶匙	调味剂	增强风味	5 克/茶匙
盐	1	茶匙	调味剂	增强风味	6 克/茶匙
小苏打	1	茶匙	膨松剂	膨胀和扩散	4.8 克/茶匙
巧克力豆	2	杯	混合物	风味和质地	170 克/杯

我已经按类型组织了配料，并包括了它们的数量、单位、用途和重量计量。您想查看有关特定配料的任何其他详细信息吗？

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

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

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

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

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

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

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

是

assistant (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)

显示网址

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

这是 horse_breeds 数据库的仪表板 URL：

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof%3A%2F%2Fcloud.fireproof.direct%2F&localName=horse_breeds&remoteName=019414e1-2db0-70aa-b9a4-2e2f78a7adce

您可以使用此 URL 通过云界面访问和管理马品种数据。

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

将 elements 数据库同步到云

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

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

elements 数据库已成功连接到云。您可以在以下位置访问仪表板：

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof%3A%2F%2Fcloud.fireproof.direct%2F&localName=elements&remoteName=019414e1-db52-75e7-b8d0-21ce605176a7

您还想同步 cookie_ingredients 数据库吗？

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

是

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

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

这是 cookie_ingredients 数据库的仪表板 URL：

https://dashboard.fireproof.storage/fp/databases/connect?endpoint=fireproof%3A%2F%2Fcloud.fireproof.direct%2F&localName=cookie_ingredients&remoteName=019414e2-1f47-72d7-bf8f-a721d29a24c7

现在，所有三个数据库（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
# 要重置，请执行：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