# @airtable/mcp-cli 中文文档

规范地址：https://npmcn.com/package/%40airtable/mcp-cli/

版本：0\.2\.9
npm 元数据更新时间：2026-10-29T17:32:08.054Z
中文译文更新时间：2026-11-06T08:04:08.145Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40airtable/mcp-cli
原文对照：https://npmcn.com/package/%40airtable/mcp-cli/?lang=original
项目主页：https://github.com/Airtable/airtable-mcp-cli#readme
源码仓库：https://github.com/Airtable/airtable-mcp-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：918 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：2 个
- 首次发布：2026-04-30T21:47:21.234Z
- 最新版本发布：2026-08-07T17:12:56.511Z
- 近 30 天下载量：3998（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 8 个）

## 中文简介

Airtable MCP CLI — MCP 服务器自动发现命令

## 安装

```sh
npm install @airtable/mcp-cli
```

也可以使用：`pnpm add @airtable/mcp-cli`、`yarn add @airtable/mcp-cli`、`bun add @airtable/mcp-cli`

## README

# 空气表 MCP CLI

从航站楼管理好你们的飞机舱.

此 CLI 在运行时从 Airtable MCP 服务器中发现了命令 . `airtable-mcp tools` 显示服务器在那个时候曝光的任何信息 。 如果服务器添加,去除,或重命名一个工具,则CLI在不发布客户端的情况下反映了这一点. 见 [设计](https://npmcn.com/package/%40airtable/mcp-cli/DESIGN.md) 设计原理.

## 安装

```sh
npm install -g @airtable/mcp-cli
```

或下载独立的二进制 :

```sh
curl -fsSL https://raw.githubusercontent.com/Airtable/airtable-mcp-cli/main/install.sh | sh
```

## 快开始

准备你的 [个人访问令牌](https://airtable.com/create/tokens)。证书存储在默认配置中。 使用 `--profile <name>` 创建额外的配置文件.

```sh
airtable-mcp configure
```

发现你能够接触到的东西:

```sh
airtable-mcp tools
airtable-mcp list-bases
```

那就行动起来

```sh
airtable-mcp list-records --baseId appXXX --tableIdOrName Tasks
```

首次运行一个工具时,CLI会从服务器获取工具列表并缓存60秒. 之后,后续命令迅速. 使用 `--refresh` 用于绕过缓存的任何工具命令.

> **这种CLI是实验性的,工具名称,参数,输出格式可能会不经通知而改变.** 今天看到的工具可能会被重新命名,去掉,或者在未来的服务器更新中改变它们的参数. 如果您是在针对特定工具进行脚本编写, 请在调用和处理输出中缺失或出乎意料的字段之前检查工具存在性 .

## 图标

```
airtable-mcp configure               Set up personal access token
airtable-mcp whoami                   Show current auth status
airtable-mcp logout                   Remove saved credentials
airtable-mcp tools                    List available tools
airtable-mcp <tool> [--flags]         Run a tool
airtable-mcp <tool> --help, -h        Show help and flags for a tool
airtable-mcp completions <shell>      Generate shell completions (bash, zsh, fish)
airtable-mcp --help, -h               Show help
airtable-mcp --version, -v            Print version
```

大多数命令接受 `--profile <name>` 在账户之间切换.

## 旗帜

工具输出默认格式化的 JSON 。 这个 `tools` 命令默认为可读列表.

| 旗帜 | 适用于 | 说明 |
| --- | --- | --- |
| `--profile <name>` | 全部 | 使用一个命名的配置文件 |
| `--json` | `tools` | 输出工具列表为 JSON |
| `--refresh` | `tools`, (中文(简体) ), `<tool>` | 通过工具缓存 |
| `--output raw` | `<tool>` | 原始文本输出而不是 JSON |
| `--input -` | `<tool>` | 从 stdin 读取参数为 JSON |
| `-q`, (中文(简体) ), `--quiet` | `<tool>` | 在 stderr 上禁止状态信息 |

## 简介

管理多个账户 :

```sh
airtable-mcp configure --profile work
airtable-mcp configure --profile personal
airtable-mcp tools --profile work
```

## 技能

为共同工作流程安装预建的技能 :

```sh
npx skills add airtable/skills
```

其他安装方法可见于 [空中技能回收](https://github.com/Airtable/skills)。 。 。 .

## 自动化和代理

这种CLI意在由脚本和代理驱动. 旗帜,输出行为,和退出代码是稳定的部分. 工具名称和计划不是;它们来自运行时的服务器.

有用的部件 :

-   **`AIRTABLE_TOKEN`**: 跳过 `configure`,在 CI 中有用
-   **`tools --json`**: 在方案上发现工具
-   **`--input -`**: 以 JSON 的标准通过参数
-   **`-q`**:保持 stdout 干净
-   **`--output raw`**: 返回服务器响应而不使用 JSON 格式

示例

```sh
export AIRTABLE_TOKEN=pat_xxx
airtable-mcp tools --json
echo '{"baseId":"appXXX","tableIdOrName":"Tasks"}' | airtable-mcp list-records --input - -q
```

## 环境变量

| 变量 | 说明 |
| --- | --- |
| `AIRTABLE_TOKEN` | 个人出入证. 覆盖 `airtable-mcp configure`。 。 。 . |
| `AIRTABLE_MCP_ENDPOINT` | MCP 服务器 URL( 默认 ): `https://mcp.airtable.com/mcp`) (中文(简体) ). |

端点限制在 HTTPS 上 `*.airtable.com` 以防止向任意服务器过滤符号.

## 配置

配置存储于 `~/.airtable/cli.json` 带有限制文件权限( e)`0600`) (中文(简体) ). 配置目录创建于 `0700` 权限。 工具定义被缓存于 `~/.airtable/cache-{profile}.json` (单位:千美元)`0600`)带有60秒TTL. 在读取后, 缓存会被对照存储的散列检查以检测腐败, 缓存的工具元数据在打印前有控制并脱去的字符 。 对一个已经可以以用户身份运行代码的本地攻击者来说, 也不是一种辩护; 将缓存文件作为信任文件, 仅以您的用户账户为限 .

## 发展

```sh
npm install
npm run build
npm run typecheck
npm test
```

本地安装为 `airtable-mcp` 命令 :

```sh
npm run build
npm link
```

之后 `npm link`,仅重运行 `npm run build` 来取取变化——不需要再连接.

完成时解除链接 :

```sh
npm unlink -g @airtable/mcp-cli
```

## 许可证

麻省理工学院

## 常见问题

### @airtable/mcp-cli 是什么？

Airtable MCP CLI — MCP 服务器自动发现命令

### 如何安装 @airtable/mcp-cli？

在项目目录运行 npm install @airtable/mcp-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 airtable-mcp，可以用 npx airtable-mcp 直接运行。

### @airtable/mcp-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/airtable\_\_mcp-cli 是否存在。

### @airtable/mcp-cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @airtable/mcp-cli 可以商用吗？

@airtable/mcp-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @airtable/mcp-cli 的下载量有多少？

根据 npm 官方下载统计，@airtable/mcp-cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,998 次，日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @airtable/mcp-cli 还在维护吗？

最新版本 0\.2\.9 发布于 2026/08/08（3 个月前）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/05/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。