Airtable MCP

🚀 Airtable MCP

将您的AI工具直接连接到Airtable。通过自然语言查询、创建、更新和删除记录。功能包括基础管理、表格操作、模式转换、记录过滤和数据迁移——所有这些都通过与Claude Desktop和其他Claude驱动编辑器兼容的标准MCP接口实现。

🚀 快速开始

1. 获取您的Airtable凭证

   • 从您的账户页面获取Airtable API令牌。
   • 从您的Airtable基础URL中获取基础ID（格式：appi7fWMQcB3BNzPs）。

2. 配置Claude Desktop

   • 打开~/Library/Application Support/Claude/claude_desktop_config.json。
   • 添加以下配置：

{
    "mcpServers": {
        "airtable-mcp": {
            "command": "npx",
            "args": [
                "@smithery/cli",
                "run",
                "@rashidazarang/airtable-mcp",
                "--token",
                "YOUR_AIRTABLE_TOKEN",
                "--base",
                "YOUR_BASE_ID"
            ]
        }
    }
}

- 用您的实际凭证替换`YOUR_AIRTABLE_TOKEN`和`YOUR_BASE_ID`。
- 保存并重新启动Claude Desktop。

3. 开始使用Airtable工具
   • 打开Claude Desktop。
   • 等待30秒建立连接。
   • 使用自然语言开始与您的Airtable数据交互。

✨ 主要特性

• 基础管理：列出和选择Airtable基础。
• 表格操作：浏览表格、字段和记录。
• 数据访问：读取、创建、更新和删除记录。
• 模式管理：导出、比较和更新模式。
• 自然语言界面：使用普通英语与您的Airtable数据交互。

📦 安装指南

本项目主要是配置相关步骤，按照上述“快速开始”中的步骤操作即可完成安装配置。

💻 使用示例

基础用法

以下是配置Claude Desktop时添加配置的代码示例：

{
    "mcpServers": {
        "airtable-mcp": {
            "command": "npx",
            "args": [
                "@smithery/cli",
                "run",
                "@rashidazarang/airtable-mcp",
                "--token",
                "YOUR_AIRTABLE_TOKEN",
                "--base",
                "YOUR_BASE_ID"
            ]
        }
    }
}

高级用法

在实际使用中，您可以根据不同的需求使用不同的工具，例如：

• 使用list_bases工具列出所有可访问的Airtable基础，在Claude Desktop中输入“显示我所有的Airtable基础”。
• 使用create_records工具在 Contacts 表中创建一个名为 John 的新记录，在Claude Desktop中输入“在 Contacts 表中创建一个名为 John 的新记录”。

📚 详细文档

可用工具

故障排除

常见问题

1. 连接问题
   • 确保安装了Node.js（node -v应显示v14或更高版本）。
   • 验证您的API令牌和基础ID是否正确。
   • 在配置更改后重新启动Claude Desktop。
2. 数据问题
   • 检查是否有任何拼写错误或格式错误。
   • 确保您有足够的权限访问目标数据。
   • 尝试使用不同的查询参数进行测试。
3. 性能问题
   • 优化您的查询以减少复杂性。
   • 确保您的网络连接稳定。
   • 清理不必要的缓存和临时文件。

解决方案

• 检查日志：查看详细的错误信息以获得更多上下文。
• 重新安装依赖项：有时重新安装Node模块可以解决问题。
• 联系支持团队：如果问题持续，寻求专业帮助。

📄 许可证

本项目采用MIT License。

🔗 参考资料

• Airtable API文档
• Claude Desktop集成指南

🤝 贡献

欢迎贡献！请参考贡献指南了解如何参与。