Airtable MCP Server

🤖 革命性的AI代理 v3.2.5 - 先进的AI驱动的Airtable MCP服务器，具有固定的TypeScript架构，世界级的项目组织，全面的智能能力，预测分析和企业自动化功能。

🚀 最新版本：v3.2.5 - 可选基础ID及增强多基础支持

主要改进，完全向后兼容：

• 🔓 可选基础ID - 开始时无需指定基础，使用list_bases工具发现它们
• 🔍 增强的基础发现 - 新的list_bases工具完全用TypeScript实现
• 🎯 动态基础选择 - 按工具调用指定基础ID，无需启动要求
• ✅ 修复问题#9 - 解决“启动时需要基础”的限制
• 🔧 改进治理 - 多基础工作流的智能基础允许列表处理
• 📦 完整的STDIO支持 - 确认与Claude Desktop/Code兼容

📋 上一个版本：v3.2.4 - XSS安全修复及全面保护

主要改进，完全向后兼容：

• 🔧 TypeScript架构固定 - 解决编译问题，正确分离类型和运行时代码
• 📁 世界级组织 - 重新组织项目，包括src/typescript, src/javascript, src/python
• 🔒 安全修复完成 - 完全解决命令注入漏洞，进行全面验证
• 🔷 TypeScript实现 - 完整的类型安全服务器，严格的验证
• 📘 全面类型定义 - 所有33个工具和10个AI提示完全类型化
• 🛡️ 编译时安全性 - 使用高级类型检查在运行时之前捕获错误
• 🎯 开发者体验 - IntelliSense，自动完成功能和重构支持
• 🔄 双重分发 - 使用JavaScript或TypeScript，任选其一

🤖 AI智能套件

完整的AI驱动智能，具有企业级功能：

• 🤖 10个AI提示模板 - 高级分析，预测和自动化
• 🔮 预测分析 - 带置信区间的预测和趋势分析
• 🗣️ 自然语言处理 - 使用人类语言查询数据
• 📊 商业智能 - 自动洞察和建议
• 🏗️ 智能模式设计 - AI优化的数据库架构
• ⚡ 工作流程自动化 - 智能过程优化
• 🔍 数据质量审计 - 综合质量评估和修复
• 📈 统计分析 - 带显著性测试的高级分析

✨ 特性

• 🔍 自然语言查询 - 用普通英语询问关于您的数据的问题
• 📊 完整的CRUD操作 - 创建，读取，更新和删除记录
• 🪝 Webhook管理 - 创建和管理实时通知的webhook
• 🏗️ 高级模式管理 - 创建表，字段，并管理基础结构
• 🔍 基础发现 - 探索所有可访问的基础及其模式
• 🔧 字段管理 - 编程地添加，修改和移除字段
• 🔐 安全认证 - 使用环境变量进行凭据管理
• 🚀 简单设置 - 提供多种安装选项
• ⚡ 快速且可靠 - 使用Node.js构建以获得最佳性能
• 🎯 33个强大的工具 - 完整覆盖Airtable API并支持批处理操作
• 📎 附件管理 - 通过URL上传文件到附件字段
• ⚡ 批处理操作 - 一次创建，更新或删除多达10条记录
• 👥 协作工具 - 管理基础协作者和共享视图
• 🤖 AI集成 - 提示和采样用于智能数据操作
• 🔐 企业级安全 - OAuth2，速率限制，全面验证

📋 先决条件

• 在系统上安装Node.js 14+
• 一个带有个人访问令牌的Airtable账户
• 您的Airtable基础ID

🚀 快速开始

第一步：获取您的Airtable凭据

1. 个人访问令牌：访问Airtable账户 → 创建具有以下范围的令牌：

   • data.records:read - 从表中读取记录
   • data.records:write - 创建，更新，删除记录
   • schema.bases:read - 查看表模式
   • schema.bases:write - v1.5.0新增 - 创建/修改表和字段
   • webhook:manage - （可选）用于webhook功能

2. 基础ID：打开您的Airtable基础并从URL中复制ID：

   https://airtable.com/[BASE_ID]/...
   

第二步：安装

选择以下安装方法之一：

🔷 TypeScript用户（推荐用于开发）

# 安装支持TypeScript
npm install -g @rashidazarang/airtable-mcp

# 为开发安装类型
npm install --save-dev typescript @types/node

📦 JavaScript用户（生产就绪）

选项A：通过NPM安装（推荐）

npm install -g @rashidazarang/airtable-mcp

选项B：从GitHub克隆

git clone https://github.com/rashidazarang/airtable-mcp.git
cd airtable-mcp
npm install

第三步：设置环境变量

在项目目录中创建一个.env文件：

AIRTABLE_TOKEN=您的个人访问令牌
AIRTABLE_BASE_ID=您的基础ID  # 可选 - 可以使用list_bases工具发现

v3.2.5新增：AIRTABLE_BASE_ID现在是可选的！您可以：

• 不指定基础ID并使用list_bases工具动态发现您的可访问基础
• 在每个工具调用中动态指定基础ID
• 设置默认基础以方便使用（推荐）

安全提示：切勿将.env文件提交到版本控制！

第四步：配置您的MCP客户端

🔷 TypeScript配置（增强的开发者体验）

添加到您的Claude Desktop配置文件中，使用TypeScript二进制文件：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "airtable-typescript": {
      "command": "npx",
      "args": ["@rashidazarang/airtable-mcp"],
      "env": {
        "AIRTABLE_TOKEN": "您的Airtable令牌",
        "AIRTABLE_BASE_ID": "您的基础ID",
        "NODE_ENV": "production",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

注意：AIRTABLE_BASE_ID是可选的。省略它以使用list_bases工具发现基础。

📦 JavaScript配置（标准）

添加到您的Claude Desktop配置文件中：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["@rashidazarang/airtable-mcp"],
      "env": {
        "AIRTABLE_TOKEN": "您的Airtable令牌",
        你的基础ID
      }
    }
  }
}

注意：AIRTABLE_BASE_ID是可选的。省略它以使用list_bases工具发现基础。

无基础ID配置（新！）

不指定基础并动态发现：

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["@rashidazarang/airtable-mcp"],
      "env": {
        "AIRTABLE_TOKEN": "您的Airtable令牌"
      }
    }
  }
}

然后使用list_bases工具发现您的可访问基础！

第五步：重启您的MCP客户端

配置完成后，重启Claude Desktop或您的MCP客户端以加载Airtable服务器。

🎯 使用示例

配置完成后，您可以自然地与您的Airtable数据交互：

🔷 TypeScript开发

import { 
  AirtableMCPServer, 
  ListRecordsInput, 
  AnalyzeDataPrompt 
} from '@rashidazarang/airtable-mcp/types';

const server = new AirtableMCPServer();

// 类型安全的数据操作
const params: ListRecordsInput = {
  table: '任务',
  maxRecords: 10,
  filterByFormula: "状态 = '活动'"
};

const records = await server.handleToolCall('list_records', params);

// 类型安全的AI分析
const analysis: AnalyzeDataPrompt = {
  table: '销售',
  analysis_type: '预测',
  confidence_level: 0.95
};

const insights = await server.handlePromptGet('analyze_data', analysis);

📦 自然语言交互

基本操作

"列出我可访问的所有Airtable基础"
"显示项目表中的所有记录"
"创建一个新的优先级为'高'且截止日期为明天的任务"
"更新任务ID rec123的状态为'已完成'"
"删除所有状态为'已归档'的记录"
"这个基础有哪些表？"
"搜索状态等于'活动'的记录"

Webhook操作（v1.4.0+）

"为我的表创建一个通知https://my-app.com/webhook的webhook"
"列出我基础中的所有活跃webhook"
"显示最近的webhook有效载荷"
"删除webhook ach123xyz"

模式管理（v1.5.0+）

"列出我可访问的所有Airtable基础"
"显示此基础的完整模式"
"描述项目表及其所有字段细节"
"创建一个名为'Tasks'的新表，包含Name，Priority和Due Date字段"
"向现有的项目表添加一个Status字段"
"Airtable有哪些可用的字段类型？"

批处理操作和附件（v1.6.0+）

"一次性在任务表中创建5个新记录"
"同时更新多个记录的新状态值"
"在一个操作中删除这3个记录"
"将此图像URL附加到记录的照片字段"
"谁是这个基础的协作者？"
"显示这个基础中的所有共享视图"

🛠️ 可用工具（总计33个）

📊 数据操作（7个工具）

工具	描述
list_tables	获取基础中的所有表及其模式信息
list_records	查询记录，可选过滤和分页
get_record	通过ID检索单个记录
create_record	向任何表添加新记录
update_record	修改现有记录字段
delete_record	从表中删除记录
search_records	使用Airtable公式和排序进行高级搜索

🪝 Webhook管理（5个工具）

工具	描述
list_webhooks	查看基础中配置的所有webhook
create_webhook	设置实时数据更改通知
delete_webhook	删除webhook配置
get_webhook_payloads	检索webhook通知历史
refresh_webhook	延长webhook过期时间

🔍 模式发现（6个工具） - v1.5.0新增

工具	描述
list_bases	列出所有可访问的Airtable基础及其权限
get_base_schema	获取任何基础的完整模式信息
describe_table	获取详细的表信息，包括所有字段规范
list_field_types	所有可用Airtable字段类型的参考指南
get_table_views	列出特定表的所有视图及其配置

🏗️ 表管理（3个工具） - v1.5.0新增

工具	描述
create_table	使用自定义字段定义创建新表
update_table	修改表名和描述
delete_table	删除表（需要安全确认）

🔧 字段管理（3个工具） - v1.5.0新增

工具	描述
create_field	向现有表添加所有字段类型的字段
update_field	修改字段属性，名称和选项
delete_field	删除字段（需要安全确认）

⚡ 批处理操作（4个工具） - v1.6.0新增

工具	描述
batch_create_records	一次最多创建10个记录以提高性能
batch_update_records	同时更新最多10个记录
batch_delete_records	在一个操作中删除最多10个记录
batch_upsert_records	根据键字段更新现有记录或创建新记录

📎 附件管理（1个工具） - v1.6.0新增

工具	描述
upload_attachment	将来自公共URL的文件附加到附件字段

👁️ 高级视图（2个工具） - v1.6.0新增

工具	描述
create_view	创建新的视图（网格，表单，日历等），带有自定义配置
get_view_metadata	获取详细的视图信息，包括过滤器和排序

🏢 基础管理（3个工具） - v1.6.0新增

工具	描述
create_base	使用初始表结构创建新的Airtable基础
list_collaborators	查看基础协作者及其权限级别
list_shares	列出共享视图及其公共配置

🤖 AI智能套件（10个提示） - v3.0.0新增

提示	描述	企业功能
analyze_data	带有ML见解的高级统计分析	置信区间，异常检测
create_report	智能报告生成和建议	多利益相关者定制，ROI分析
data_insights	商业智能和模式发现	跨表关联，预测指标
optimize_workflow	AI驱动的自动化建议	变更管理，实施路线图
smart_schema_design	符合最佳实践的数据库优化	遵守法规（GDPR，HIPAA），扩展规划
data_quality_audit	综合质量评估和修复	自动修复，治理框架
predictive_analytics	预测和趋势预测	多种算法，不确定性量化
natural_language_query	智能处理人类问题	上下文感知，置信评分
smart_data_transformation	AI辅助数据处理	质量规则，审计轨迹，优化
automation_recommendations	工作流程优化建议	技术可行性，成本效益分析

🔧 高级配置

使用Smithery Cloud

对于云托管的MCP服务器：

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "@smithery/cli",
        "run",
        "@rashidazarang/airtable-mcp",
        "--token",
        "您的令牌",
        "--base",
        "您的基础ID"
      ]
    }
  }
}

直接Node.js执行

如果您克隆了仓库：

{
  "mcpServers": {
    "airtable": {
      "command": "node",
      "args": [
        "/path/to/airtable-mcp/airtable_simple.js",
        "--token",
        "您的令牌",
        "--base",
        "您的基础ID"
      ]
    }
  }
}

🧪 测试

🔷 TypeScript测试

运行全面的TypeScript测试套件：

# 首先安装依赖项
npm install

# 运