Quickbase MCP Server

基于TypeScript的模型上下文协议（MCP）服务器，专为与Claude Desktop和其他AI助手无缝集成而设计。

📋 社区项目通知
这是一个由社区开发的集成项目，并非官方的Quickbase产品。虽然它使用了Quickbase的公共API，但并未得到Quickbase公司的正式支持。此项目“按原样”提供并由社区维护。如需官方的Quickbase产品和支持，请访问quickbase.com。

🚀 Claude Desktop 快速入门

一键安装检查

curl -fsSL https://raw.githubusercontent.com/danielbushman/MCP-Quickbase/main/check_dependencies.sh | bash

配置Claude Desktop

在你的Claude Desktop配置文件中添加以下内容：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quickbase": {
      "command": "npx",
      "args": ["-y", "mcp-quickbase"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

完成！ 重启Claude Desktop即可开始使用Quickbase工具。

---

📦 安装选项

选项1：NPM（推荐）

# 直接使用npx（无需安装）
npx -y mcp-quickbase

# 或者全局安装
npm install -g mcp-快速基础

选项2：从源代码安装

# 克隆仓库
git clone https://github.com/danielbushman/MCP-Quickbase.git
cd MCP-Quickbase

# 安装依赖
npm install

# 构建项目
npm run build

对于源代码安装，使用以下Claude Desktop配置：

{
  "mcpServers": {
    "quickbase": {
      "command": "node",
      "args": ["/path/to/MCP-Quickbase/dist/mcp-stdio-server.js"],
      "env": {
        "QUICKBASE_REALM_HOST": "your-realm.quickbase.com",
        "QUICKBASE_USER_TOKEN": "your-user-token",
        "QUICKBASE_APP_ID": "your-app-id"
      }
    }
  }
}

🔧 配置

服务器可以在未配置环境变量的情况下启动，但在提供正确的配置之前，工具将无法正常工作。使用check_configuration工具来验证您的设置。

必要的环境变量

• QUICKBASE_REALM_HOST - 您的Quickbase领域（例如：company.quickbase.com）
• QUICKBASE_USER_TOKEN - 您的Quickbase API令牌（在这里获取）

可选的环境变量

• QUICKBASE_APP_ID - 默认应用程序ID

可选设置

• QUICKBASE_CACHE_ENABLED - 启用缓存（true/false，默认值：true）
• QUICKBASE_CACHE_TTL - 缓存持续时间（秒，默认值：3600）
• DEBUG - 启用调试日志（true/false，默认值：false）
• LOG_LEVEL - 日志级别（DEBUG/INFO/WARN/ERROR，默认值：INFO）

🛠️ 可用工具

连接与配置

• check_configuration - 检查Quickbase配置是否正确设置
• test_connection - 测试连接到Quickbase
• configure_cache - 配置缓存行为

应用程序管理

• create_app - 创建新的Quickbase应用程序
• update_app - 更新现有应用程序
• list_tables - 列出应用程序中的所有表

表操作

• create_table - 创建新表
• update_table - 更新表属性
• get_table_fields - 获取表字段信息

字段管理

• create_field - 在表中创建新字段
• update_field - 更新字段属性

记录操作

• query_records - 查询记录，包括过滤和排序
• create_record - 创建单个记录
• update_record - 更新现有记录
• bulk_create_records - 创建多条记录
• bulk_update_records - 更新多条记录

文件操作

• upload_file - 将文件上传到文件附件字段
• download_file - 从记录下载文件

报告

• run_report - 执行Quickbase报告

📚 使用示例

基本记录查询

查询客户表中的所有客户

创建新记录

创建一个新客户记录，名称为"Acme Corp"，状态为"Active"

上传文件

将invoice.pdf上传到记录123的Documents字段

🔒 安全性

• API令牌处理安全，不会被记录
• 所有文件操作都在工作目录中隔离
• 支持字段级别的权限和访问控制

📋 要求

• Node.js 18或更高版本
• 具有API访问权限的有效Quickbase账户
• Claude Desktop（用于MCP集成）

🤝 贡献

欢迎贡献！请随时提交Pull Request。

📄 许可证

该项目采用MIT许可证 - 查看LICENSE文件以获取详细信息。

🔗 链接

• Quickbase API 文档
• 模型上下文协议
• Claude Desktop