Quickbase MCP服务器
用于Quickbase的基于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桌面版
将此添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %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（推荐）
# 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)
🛠️ 可用工具（25）
连接和配置
check_configuration-检查Quickbase配置是否设置正确test_connection-测试与Quickbase的连接configure_cache-配置缓存行为
应用管理
create_app-创建新的Quickbase应用程序update_app-更新现有应用程序list_tables-列出应用程序中的所有表
表操作
create_table-创建新表update_table-更新表属性get_table_fields-获取表的字段信息
现场管理
create_field-在表中创建新字段get_field-获取特定字段的属性update_field-更新字段属性delete_field-从表中删除字段
记录操作
query_records-使用过滤、排序和groupBy查询记录create_record-创建单个记录update_record-更新现有记录bulk_create_records-创建多条记录bulk_update_records-更新多条记录
文件操作
upload_file-将文件上传到文件附件字段download_file-从记录中下载文件
关系管理
get_relationships-获取表关系create_relationship-创建新的表关系update_relationship-更新现有关系delete_relationship-删除表关系
报告
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集成）
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。