金大哥 - airtable-mcp MCP 详情

article

README

🚀 Airtable MCP

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

🚀 快速开始

获取您的Airtable凭证
- 从您的账户页面获取Airtable API令牌。
- 从您的Airtable基础URL中获取基础ID（格式：appi7fWMQcB3BNzPs）。
配置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 的新记录”。

📚 详细文档

可用工具

| 属性 | 详情 | |------|------| | 工具名称 | 描述 | 示例用法 | | list_bases | 列出所有可访问的Airtable基础 | "显示我所有的Airtable基础" | | list_tables | 列出当前基础中的所有表格 | "这个基础中有哪些表格？" | | list_records | 列出记录，带可选过滤 | "显示项目表中的所有记录" | | get_record | 获取特定记录 | "获取任务表中编号ABC123的记录" | | create_records | 创建新记录 | "在 Contacts 表中创建一个名为 John 的新记录" | | update_records | 更新现有记录 | "将状态更新为完成，在记录 XYZ 中" | | set_base_id | 切换到不同的基础 | "切换到基础 appi7fWMQcB3BNzPs" |

故障排除

常见问题

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

解决方案

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

📄 许可证

本项目采用MIT License。

🔗 参考资料

🤝 贡献

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

airtable-mcp