Quickbase MCP 服务器

Quickbase 的基于 TypeScript 的模型上下文协议 (MCP) 服务器，旨在与 Claude Desktop 和其他 AI 助手无缝集成。

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

🚀 Claude 桌面快速入门

单线设置检查

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

配置 Claude 桌面

将其添加到您的 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 工具了。

Related MCP server: crm-mcp

📦安装选项

选项 1：NPM（推荐）

# Use directly with npx (no installation needed)
npx -y mcp-quickbase

# Or install globally
npm install -g mcp-quickbase

选项 2：从源头

# Clone the repository
git clone https://github.com/danielbushman/MCP-Quickbase.git
cd MCP-Quickbase

# Install dependencies
npm install

# Build the project
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 报告

📚 使用示例

基本记录查询

Query all customers from the Customers table

创建新记录

Create a new customer record with name "Acme Corp" and status "Active"

上传文件

Upload invoice.pdf to the Documents field in record 123

🔒 安全

• API 令牌得到安全处理，并且不会被记录

• 所有文件操作均在工作目录中进行沙盒化

• 支持字段级权限和访问控制

📋 要求

• Node.js 18 或更高版本

• 具有 API 访问权限的有效 Quickbase 帐户

• Claude Desktop（用于 MCP 集成）

🤝 贡献

欢迎贡献代码！欢迎提交 Pull 请求。

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

🔗 链接

• Quickbase API 文档

• 模型上下文协议

• 克劳德桌面