🚀 瞬间数据库服务器 (InstantDB Server)
这是一个用于与 InstantDB 交互的 MCP 服务器。它提供了一个只读接口，借助动态加载的架构和环境配置来查询 InstantDB，还包含执行查询以及根据预定义模式检索查询示例的工具。
🚀 快速开始
若要与 Claude 桌面一起使用该服务器，需将以下配置添加到您的 Claude 桌面设置中：
- 在 macOS 上：
~/Library/Application Support/Claude/claude_desktop_config.json - 在 Windows 上：
%APPDATA%/Claude/claude_desktop_config.json
示例配置如下：
{
"mcpServers": {
"instantdb-server": {
"command": "node",
"args": ["/path/to/instantdb-server/build/index.js"],
"env": {
"INSTANT_APP_ID": "your_app_id",
"INSTANT_APP_ADMIN_TOKEN": "your_admin_token"
},
"disabled": false,
"autoApprove": []
}
}
}
✨ 主要特性
工具
- get_examples：返回各种类别的预定义查询示例（例如，“基本读取”，“筛选”，“关联”）。
- queryDB：执行特定查询以 InstantDB。需要一个
query和一个描述性name参数。 - list_queries：检索执行的查询历史及其详细信息，例如查询 ID、名称、时间戳和结构。
- return_query：根据其唯一 ID 检索特定查询以供以后参考或实现。
架构和环境集成
- 从项目目录的常见文件位置动态加载 InstantDB 架构（例如
instant.schema.ts，src/instant.schema.ts，app/instant.schema.ts）。 - 从项目的
.env文件加载环境变量配置。重要变量包括：INSTANT_APP_IDINSTANT_APP_ADMIN_TOKEN
待定功能
- 从常见文件位置动态检测 InstantDB 权限文件。
📦 安装指南
安装依赖项
npm install
构建服务器
npm run build
使用自动重建进行开发
npm run watch
💻 使用示例
基础用法
在开发过程中，若要使用自动重建功能，可执行以下命令：
npm run watch
高级用法
若要调试 MCP 服务器通信，请使用 MCP 检查器：
npm run inspector
检查器将提供一个 URL，以访问用于监控 MCP 服务器操作的工具。