空气表 MCP CLI
从航站楼管理好你们的飞机舱.
此 CLI 在运行时从 Airtable MCP 服务器中发现了命令 . airtable-mcp tools 显示服务器在那个时候曝光的任何信息 。 如果服务器添加,去除,或重命名一个工具,则CLI在不发布客户端的情况下反映了这一点. 见 设计 设计原理.
安装
npm install -g @airtable/mcp-cli
或下载独立的二进制 :
curl -fsSL https://raw.githubusercontent.com/Airtable/airtable-mcp-cli/main/install.sh | sh
快开始
准备你的 个人访问令牌。证书存储在默认配置中。 使用 --profile <name> 创建额外的配置文件.
airtable-mcp configure
发现你能够接触到的东西:
airtable-mcp tools
airtable-mcp list-bases
那就行动起来
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 上禁止状态信息 |
简介
管理多个账户 :
airtable-mcp configure --profile work
airtable-mcp configure --profile personal
airtable-mcp tools --profile work
技能
为共同工作流程安装预建的技能 :
npx skills add airtable/skills
其他安装方法可见于 空中技能回收。 。 。 .
自动化和代理
这种CLI意在由脚本和代理驱动. 旗帜,输出行为,和退出代码是稳定的部分. 工具名称和计划不是;它们来自运行时的服务器.
有用的部件 :
AIRTABLE_TOKEN: 跳过configure,在 CI 中有用tools --json: 在方案上发现工具--input -: 以 JSON 的标准通过参数-q:保持 stdout 干净--output raw: 返回服务器响应而不使用 JSON 格式
示例
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. 在读取后, 缓存会被对照存储的散列检查以检测腐败, 缓存的工具元数据在打印前有控制并脱去的字符 。 对一个已经可以以用户身份运行代码的本地攻击者来说, 也不是一种辩护; 将缓存文件作为信任文件, 仅以您的用户账户为限 .
发展
npm install
npm run build
npm run typecheck
npm test
本地安装为 airtable-mcp 命令 :
npm run build
npm link
之后 npm link,仅重运行 npm run build 来取取变化——不需要再连接.
完成时解除链接 :
npm unlink -g @airtable/mcp-cli
许可证
麻省理工学院