Better Airtable MCP

更好的气垫MCP

将Airtable与AI代理结合使用的更好方法！有两大特点：

• SQL查询支持（由DuckDB支持）
• 任何记录创建、修改或删除的预览和审批流程

如何设置：

1. 首选https://claude.ai/customize/connectors
2. 创建标题为的新连接器 气垫桌 使用此URL：https://better-airtable-mcp.hackclub.com/mcp
3. 将权限设置为“始终允许”- better-airtable-mcp 内置审批流，在使用web界面创建/修改/删除记录之前会提示您

______________________________________________________________________

AI生成的完整自述文件。另请参阅 SPEC.md:

Airtable的托管MCP服务器，具有快速的DuckDB支持的读取和人工批准的写入。

此存储库正在从以下位置实现 SPEC.md目前的实施包括：

• 链接到Airtable OAuth的MCP客户端的OAuth提供者流
• 与连续同步工作进程共享每个基础的DuckDB缓存
• 重新启动安全同步恢复和启动清理过时的DuckDB文件
• MCP工具 list_bases, list_schema, query, sync, mutate，以及 check_operation
• 人工审批流与捆绑的React/Vite审批SPA
• 进行单元和集成测试以及前端单元测试

工具链

回购使用 mise 要固定Go和Node：

mise install
mise exec -- npm --prefix frontend test
mise exec -- npm --prefix frontend run build
mise exec -- go test ./...
mise exec -- go build ./...

容器构建：

docker build -t better-airtable-mcp:dev .

本地开发

仅启动Postgres：

docker compose up -d postgres

或者从Docker Compose启动整个堆栈：

docker compose up --build app

加载本地环境文件：

set -a
source .env
set +a

运行完整的测试/构建工作流并在本地启动服务器：

mise exec -- npm --prefix frontend test
mise exec -- npm --prefix frontend run build
mise exec -- go test ./...
mise exec -- go run ./cmd/server

服务器在本地运行后，打开 http://localhost:8080/debug 要运行内置的OAuth流，请为本地服务器创建一个承载令牌，检查实时MCP工具目录，并手动执行工具调用。

对于本地Airtable OAuth测试，请在您的Airtable OAuth应用程序中注册此回调URL：

http://localhost:8080/oauth/airtable/callback

BASE_URL=http://localhost:8080 对于基于同一机器浏览器的烟雾测试来说，这很好。如果您想从托管的MCP客户端或任何不直接在本地计算机上运行的客户端进行测试，请切换 BASE_URL 并更新Airtable回调以完全匹配。

在Docker Compose中运行应用程序时，应用程序容器会覆盖 DATABASE_URL 在签入时使用内部Postgres主机名 .env.example 保留本地主机URL go run 发展。

环境

服务器需要以下环境变量：

• DATABASE_URL
• AIRTABLE_CLIENT_ID
• AIRTABLE_CLIENT_SECRET
• BASE_URL
• APP_ENCRYPTION_KEY

可选配置当前与中描述的默认值匹配 SPEC.md.