Quickbase MCP服务器
用于Quickbase的基于TypeScript的模型上下文协议（MCP）服务器，旨在与Claude Desktop和其他AI助手无缝集成。
> 📋 社区项目通知\
> 这是一个社区开发的集成，不是官方的Quickbase产品。虽然它使用Quickbase的公共API，但它并没有得到Quickbase，股份有限公司的官方支持。该项目是按原样提供的，并由社区维护。有关Quickbase的官方产品和支持，请访问 quickbase.com.
🚀 Claude Desktop快速入门
单线设置检查```bash
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````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（推荐）```bash
Use directly with npx (no installation needed)
npx -y mcp-quickbase
Or install globally
npm install -g mcp-quickbase
### 选项2：来源```bash
# 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配置：```json
{
"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许可证获得许可-请参阅 许可证 文件以获取详细信息。
🔗 链接
- Quickbase API文档
- 模型上下文协议
- 克劳德桌面版
