Quickbase MCP Connector
2025.04.09
0
PythonQuickbase 连接器AI 数据交互API 集成开发效率交流协作
Quickbase-MCP-connector 是一个基于 Model Context Protocol (MCP) 的连接器，用于与 Quickbase 的 JSON RESTful API 进行集成。它允许 AI 助手（如 Claude）通过自然语言与 Quickbase 的数据进行交互，支持管理应用、表、字段、记录、文件和报告等操作。
View on GitHub
Overview
基本能力
产品定位
Quickbase-MCP-connector 是一个用于连接 Quickbase API 的工具，旨在通过 AI 助手（如 Claude）简化与 Quickbase 数据的交互。
核心功能
- AI 驱动的 Quickbase 访问：通过自然语言与 Quickbase 数据交互。
- 数据管理：创建、查看和更新应用、表和记录。
- 文件处理：上传和下载文件附件。
- 报告访问：运行 Quickbase 报告并获取结果。
- 大数据集支持：自动处理分页查询。
适用场景
- 通过 AI 助手管理 Quickbase 数据。
- 批量操作记录和文件。
- 自动化报告生成和数据查询。
工具列表
- 连接工具：
test_connection,check_auth。 - 应用工具：
get_app,get_apps,create_app,update_app。 - 表工具：
get_table,get_tables,create_table,update_table。 - 字段工具：
get_field,get_fields,create_field,update_field。 - 记录工具：
get_record,query_records,create_record,update_record,bulk_create_records,bulk_update_records。 - 文件工具：
upload_file,download_file,manage_attachments。 - 报告工具：
run_report。
常见问题解答
- 错误处理：包括错误类型分类、HTTP 状态码、详细错误消息和建议解决方案。
- 常见错误场景：缺少参数、无效 JSON 格式、不存在的表或字段 ID、认证失败等。
使用教程
使用依赖
- Python 3.8 或更高版本。
- Node.js 14 或更高版本。
- Quickbase API 凭证（realm hostname, user token, 和 app ID）。
安装教程
- 克隆仓库：
git clone https://github.com/danielbushman/Quickbase-MCP-connector.git
cd Quickbase-MCP-connector
- 设置环境：
./setup.sh
- 配置 Quickbase 凭证：
cp .env.example .env
# 编辑 .env 文件填入凭证
调试方式
- 手动启动 MCP 服务器：
node src/quickbase/server.js
- 运行测试：
python tests/run_tests.py --all
- 检查环境变量：确保
QUICKBASE_REALM_HOST,QUICKBASE_USER_TOKEN,QUICKBASE_APP_ID已正确设置。