返回 MCP 目录
public公开dns本地运行

airtable-mcp-server

一个基于Node.js的Airtable MCP服务器,提供程序化管理Airtable基础、表格、字段和记录的功能,支持通过Claude Desktop等MCP客户端进行操作。

article

README

🚀 Airtable MCP 服务器

Airtable MCP 服务器是一个实现模型上下文协议(MCP)的服务器,为与 Airtable API 交互提供了实用工具。它借助 Claude Desktop 或其他 MCP 客户端,实现了对 Airtable 基座、表格、字段和记录的编程管理。该服务器采用专用实现方式,在构建表格时进行分阶段处理,并利用 Claude 的代理功能,最大程度降低了在其他 Airtable MCP 服务器构建复杂表格时常见的失败率。此外,还纳入了系统提示项目知识,进一步增强了功能。

🚀 快速开始

在使用 Airtable MCP 服务器之前,你需要完成安装和配置,以下是具体步骤。

📦 安装指南

安装要求

  • Node.js:请确保安装了最新版本的 Node.js。
  • Npm/yarn:确保安装了 npm 或 yarn,用于管理依赖项。

配置步骤

1. 使用 npx 安装

在终端中运行以下命令:

npx mcp init

根据提示填写相关信息并完成配置。

2. 使用 mcp-installer

下载并安装 mcp-installer 以简化设置过程。

3. 本地开发安装

克隆仓库并在项目目录中运行:

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

✨ 主要特性

支持的操作

  • 基座管理:可创建、读取、更新和删除基座。
  • 表格管理:能够管理表格及其字段配置。
  • 字段类型:支持多种字段类型,包括单线文本、多行文本、电子邮件、电话号码、数字、货币、日期、单选和多选。

字段颜色

支持以下颜色主题:

  • 蓝色亮红色亮绿色亮
  • 黄色亮紫色亮粉色亮
  • 灰色亮青色亮橙色亮
  • 蓝色暗1绿色暗1

💻 使用示例

基础用法

以下是一个示例代码,展示了如何定义字段:

{
  "fields": {
    "name": {
      "type": "singleLineText",
      "required": true
    },
    "description": {
      "type": "multiLineText",
      "default": ""
    }
  }
}

📚 详细文档

贡献指南

如何贡献

  1. 创建问题:在 GitHub 上报告问题或功能需求。
  2. 创建分支:为新功能或修复创建独立的分支。
  3. 提交代码:提交更改并添加详细的提交信息。
  4. 创建拉取请求:提交更改后,创建拉取请求以合并到主分支。

开发指南

  • 使用 TypeScript 编写新代码。
  • 遵循语义化提交消息格式。
  • 更新相关文档和示例。
  • 保持代码风格一致。

获取帮助

  • 问题报告:在 GitHub 上打开问题页面。
  • 参与讨论:加入现有议题或拉取请求的讨论。
  • 寻求解答:在拉取请求中提问。

我们欢迎所有贡献,以使 Airtable MCP 服务器更加强大和用户友好!无论是添加新功能、修复错误还是改进文档,您的帮助都非常宝贵!

📄 许可证

MIT

由衷制作
Airtable MCP 社区

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端