instantdb-server MCP 服务器

用于与 InstantDB 交互的 MCP 服务器。

此服务器提供了一个只读接口，用于使用动态加载的模式和环境配置查询 InstantDB。它包括执行查询和根据预定义模式检索查询示例的工具。

功能

工具

• <code>get_examples</code>
  返回各种类别（例如，“basic_read”、“filtering”、“associations”）的预定义示例查询。

• <code>queryDB</code>
  针对 InstantDB 执行特定查询。需要一个 <code>query</code> 和一个描述性的 <code>name</code> 参数。

• <code>list_queries</code>
  检索已执行查询的历史记录，其中包含查询 ID、名称、时间戳和结构等详细信息。

• <code>return_query</code>
  通过其唯一 ID 检索特定查询，以供稍后参考或实现。

模式和环境集成

• 从相对于提供的项目目录的常见文件位置（例如，<code>instant.schema.ts</code>、<code>src/instant.schema.ts</code>、<code>app/instant.schema.ts</code>）动态加载 InstantDB 模式。
• 环境变量配置从项目的 <code>.env</code> 文件加载。 必要的变量包括：
  • <code>INSTANT_APP_ID</code>
  • <code>INSTANT_APP_ADMIN_TOKEN</code>

待定功能

• 从常见文件位置动态检测 InstantDB 权限文件。

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

安装

要将服务器与 Claude Desktop 一起使用，请将以下配置添加到您的 Claude Desktop 设置：

在 macOS 上： <code>~/Library/Application Support/Claude/claude_desktop_config.json</code>
在 Windows 上： <code>%APPDATA%/Claude/claude_desktop_config.json</code>

配置示例：

{
  "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": []
    }
  }
}

调试

要调试 MCP 服务器通信，请使用 MCP Inspector：

npm run inspector

Inspector 将提供一个 URL 来访问用于监视 MCP 服务器操作的工具。