🚀 QuickBase MCP 服务器

QuickBase MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它为 QuickBase 操作提供了极大的灵活性。通过 MCP 工具，你可以使用该服务器创建表格、添加字段、修改关系，并执行所有 QuickBase 操作。

✨ 主要特性

应用管理

• 获取应用信息
• 列出所有表格
• 测试连接

表格操作

• 创建新表格
• 获取表格信息
• 更新表格属性
• 删除表格

字段管理

• 获取表格的所有字段
• 创建新字段（支持所有类型）
• 更新现有字段
• 删除字段
• 支持查找、公式和关系

记录操作

• 通过过滤和排序查询记录
• 获取特定记录
• 创建单条或多条记录
• 更新现有记录
• 删除记录
• 通过文本搜索记录
• 批量操作

关系管理

• 创建父子关系
• 获取现有关系
• 外键管理

实用功能

• 获取并运行报告
• 高级查询功能
• 错误处理和重试逻辑

📦 安装指南

1. 克隆并设置服务器：

cd quickbase-mcp-server
npm install

2. 复制环境配置：

cp env.example .env

3. 在 .env 中配置你的 QuickBase 凭证：

# QuickBase 配置
QB_REALM=yourname.quickbase.com
QB_USER_TOKEN=your_quickbase_user_token_here
QB_APP_ID=yourid

# 可选：默认设置
QB_DEFAULT_TIMEOUT=30000
QB_MAX_RETRIES=3

# MCP 服务器配置
MCP_SERVER_NAME=quickbase-mcp
MCP_SERVER_VERSION=1.0.0

4. 构建项目：

npm run build

💻 使用示例

独立运行服务器：

npm start

添加到你的 MCP 客户端配置：

将以下内容添加到你的 MCP 客户端配置（例如，Claude Desktop）中：

{
  "mcpServers": {
    "quickbase": {
      "command": "node",
      "args": ["/path/to/quickbase-mcp-server/dist/index.js"],
      "env": {
        "QB_REALM": "yourname.quickbase.com",
        "QB_USER_TOKEN": "your_token_here",
        "QB_APP_ID": "yourid"
      }
    }
  }
}

可用工具

应用工具

• quickbase_get_app_info - 获取应用信息
• quickbase_get_tables - 列出所有表格
• quickbase_test_connection - 测试连接

表格工具

• quickbase_create_table - 创建新表格
• quickbase_get_table_info - 获取表格详情
• quickbase_delete_table - 删除表格

字段工具

• quickbase_get_table_fields - 获取所有字段
• quickbase_create_field - 创建新字段
• quickbase_update_field - 更新现有字段
• quickbase_delete_field - 删除字段

记录工具

• quickbase_query_records - 通过过滤和排序查询记录
• quickbase_get_record - 获取特定记录
• quickbase_create_record - 创建新记录
• quickbase_update_record - 更新现有记录
• quickbase_delete_record - 删除记录
• quickbase_bulk_create_records - 创建多条记录
• quickbase_search_records - 通过文本搜索记录

关系工具

• quickbase_create_relationship - 创建表格关系
• quickbase_get_relationships - 获取现有关系

实用工具

• quickbase_get_reports - 获取所有报告
• quickbase_run_report - 运行特定报告

基础用法

创建新表格：

{
  "name": "quickbase_create_table",
  "arguments": {
    "name": "New Projects",
    "description": "Project tracking table"
  }
}

向表格添加字段：

{
  "name": "quickbase_create_field",
  "arguments": {
    "tableId": "bu65pc8px",
    "label": "Project Status",
    "fieldType": "text_choice",
    "choices": ["Planning", "Active", "Complete", "On Hold"],
    "required": true
  }
}

通过过滤查询记录：

{
  "name": "quickbase_query_records",
  "arguments": {
    "tableId": "bu65pc8px",
    "where": "{6.EX.'John'}",
    "top": 10,
    "sortBy": [{"fieldId": 3, "order": "DESC"}]
  }
}

创建新记录：

{
  "name": "quickbase_create_record",
  "arguments": {
    "tableId": "bu65pc8px",
    "fields": {
      "6": {"value": "John Doe"},
      "7": {"value": "123 Main St"},
      "8": {"value": "john@example.com"}
    }
  }
}

📚 详细文档

支持的字段类型

• text - 单行文本
• text_choice - 单选下拉框
• text_multiline - 多行文本
• richtext - 富文本编辑器
• numeric - 数字字段
• currency - 货币字段
• percent - 百分比字段
• date - 日期字段
• datetime - 日期/时间字段
• checkbox - 复选框字段
• email - 电子邮件字段
• phone - 电话号码字段
• url - URL 字段
• address - 地址字段
• file - 文件附件
• lookup - 从另一个表格查找
• formula - 计算字段
• reference - 表格引用

开发

在开发模式下运行：

npm run dev

运行测试：

npm test

故障排除

常见问题

1. 身份验证错误

   • 检查你的用户令牌是否正确
   • 验证令牌权限是否包括你的应用
   • 确保领域主机名正确

2. 未找到表格/字段

   • 验证表格/字段 ID 是否正确
   • 检查你是否有访问权限

3. 字段创建失败

   • 检查字段类型是否受支持
   • 验证选择字段是否提供了选项
   • 确保公式字段的公式语法正确

启用调试日志

设置环境变量：

DEBUG=quickbase-mcp:*

实现说明

该服务器通过以下方式为 QuickBase 操作提供了最大的灵活性：

1. 直接 API 访问 - 直接使用 QuickBase REST API v1
2. 完整的字段支持 - 支持所有 QuickBase 字段类型
3. 关系管理 - 可以创建和管理表格关系
4. 批量操作 - 高效的批量记录操作
5. 高级查询 - 支持完整的 QuickBase 查询语法
6. 错误处理 - 全面的错误处理和重试逻辑

📄 许可证

本项目采用 MIT 许可证。