DA

domdomegg/airtable-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

456 stars 131 forks 质量 78 趋势 40MIT

🗂️🤖 Airtable模型上下文协议服务器,允许AI系统与你的Airtable基底交互

概览

一个模型上下文协议服务器,提供对 Airtable 数据库的读写访问。该服务器使大型语言模型能够检查数据库模式,然后读写记录。 https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944 按照install-mcp上的说明操作,它会生成适合你MCP客户端的配置(Claude Code、Claude Desktop、Cursor、Cline、VS Code等)。 你需要一个 Airtable 个人访问令牌——在这里创建一个,包含 schema.bases:read 和 data.records:read(还有可选的 schema.bases:write、data.records:write、data.recordComments:read、data.recordComments:write)以及你想使用的基址访问权限。它看起来像 pat123.abc123(但更长)。设置为 AIRTABLE_API_KEY(替换生成配置中的占位符)。

概述(AI 翻译)

一个模型上下文协议服务器,提供对 Airtable 数据库的读写访问。该服务器使大型语言模型能够检查数据库模式,然后读写记录。

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

安装

按照install-mcp上的说明操作,它会生成适合你MCP客户端的配置(Claude Code、Claude Desktop、Cursor、Cline、VS Code等)。

你需要一个 Airtable 个人访问令牌——在这里创建一个,带作用域 schema.bases:read 和 data.records:read(可选地 schema.bases:write、data.records:write、data.recordComments:read、[data.recordComments:write),并能访问你想使用的基地。它看起来像 pat123.abc123(但更长)。设置为 AIRTABLE_API_KEY(替换生成配置中的占位符)。

组成部分

工具

  • list_records
  • 列出指定Airtable中的记录
  • 输入参数:
  • baseId(字符串,必需):Airtable基底的ID
  • tableId(字符串,必需):查询表的ID
  • maxRecords(编号,可选):返回记录的最大数量。默认为100。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

airtable-mcp-server

A Model Context Protocol server that provides read and write access to Airtable databases. This server enables LLMs to inspect database schemas, then read and write records.

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

Installation

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

You’ll need an Airtable personal access token — create one here with scopes schema.bases:read and data.records:read (and optionally schema.bases:write, data.records:write, data.recordComments:read, data.recordComments:write), and access to the bases you want to use. It looks something like pat123.abc123 (but longer). Set it as AIRTABLE_API_KEY (replacing the placeholder in the generated config).

Components

Tools

  • list_records

    • Lists records from a specified Airtable table
    • Input parameters:
      • baseId (string, required): The ID of the Airtable base
      • tableId (string, required): The ID of the table to query
      • maxRecords (number, optional): Maximum number of records to return. Defaults to 100.
      • filterByFormula (string, optional): Airtable formula to filter records
  • search_records

    • Search for records containing specific text
    • Input parameters:
      • baseId (string, required): The ID of the Airtable base
      • tableId (string, required): The ID of the table to query
      • searchTerm (string, required): Text to search for in records
      • fieldIds (array, optional): Specific field IDs to search in. If not provided, searches all text-based fields.
      • maxRecords (number, optional): Maximum number of records to return. Defaults to 100.
  • list_bases

    • Lists all accessible Airtable bases
    • No input parameters required
    • Returns base ID, name, and permission level
  • list_tables

    • Lists all tables in a specific base
    • Input parameters:
      • baseId (string, required): The ID of the Airtable base
      • detailLevel (string, optional): The amount of detail to get about the tables (tableIdentifiersOnly, identifiersOnly, or full)
    • Returns table ID, name, description, fields, and views (to the given detailLevel)
  • describe_table

    • Gets detailed information about a specific table
    • Input parameters:
      • baseId (string, required): The ID of the Airtable base
      • tableId (string, required): The ID of the table to describe
      • detailLevel (string, optional): The amount of detail to get about the table (tableIdentifiersOnly, identifiersOnly, or full)
    • Returns the same format as list_tables but for a single table
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →