@ air/ mcp (英语)
MCP 服务器 空运 平台。 将任何 MCP 兼容的 AI 客户端连接到您的 Air 工作空间, 允许进行资产搜索、 棋盘管理、 标记、 自定义字段等 .
支持两者 科学、技术和科学司 (直接过程)和 HTTP/SSE 软件 (本地主服务器) 传输.
先决条件
- 节点.js 18+
- Air API 密钥和工作空间ID(从您的 空气工作空间设置(中文(简体) )
快开始
克劳德桌面
添加到您的 Claude 桌面配置( E)~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上:
{
"mcpServers": {
"air": {
"command": "npx",
"args": ["-y", "@air/mcp"],
"env": {
"AIR_API_KEY": "your-api-key",
"AIR_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
nvm 用户 : Claude Desktop没有加载你的外壳配置文件,因此可能使用错误的节点版本. 如果您发现引擎出错, 请使用整个路径到一个节点 20+
npx相反:"command": "/Users/you/.nvm/versions/node/v20.19.4/bin/npx"寻找你的路径
nvm which 20在终端.
见 Claude 桌面 MCP 文件 更多细节.
克劳德代码
claude mcp add air -t stdio -e AIR_API_KEY=your-api-key -e AIR_WORKSPACE_ID=your-workspace-id -- npx -y @air/mcp
见 Claude 代码 MCP 文件 更多细节.
代码
添加到您的 Codex 配置( T)~/.codex/config.toml:
[mcp_servers.air]
command = "npx"
args = ["-y", "@air/mcp"]
[mcp_servers.air.env]
AIR_API_KEY = "your-api-key"
AIR_WORKSPACE_ID = "your-workspace-id"
或者通过CLI添加:
codex mcp add air --env AIR_API_KEY=your-api-key --env AIR_WORKSPACE_ID=your-workspace-id -- npx -y @air/mcp
见 代码 MCP 文件 关于在 Codex 中配置 MCP 服务器的更详细信息.
光标
添加为 .cursor/mcp.json 在您的项目中或 ~/.cursor/mcp.json 全球:
{
"mcpServers": {
"air": {
"command": "npx",
"args": ["-y", "@air/mcp"],
"env": {
"AIR_API_KEY": "your-api-key",
"AIR_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
见 光标 MCP 文件 更多细节.
风起浪起
添加为 ~/.codeium/windsurf/mcp_config.json数字 :
{
"mcpServers": {
"air": {
"command": "npx",
"args": ["-y", "@air/mcp"],
"env": {
"AIR_API_KEY": "your-api-key",
"AIR_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
见 Windsurf MCP 文件 更多细节.
VS 代码 (GitHub 副驾驶)
添加为 .vscode/mcp.json 在工程中,或者通过 MCP: 打开用户配置 命令 :
{
"servers": {
"air": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@air/mcp"],
"env": {
"AIR_API_KEY": "your-api-key",
"AIR_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
确保使用副驾驶器 代理模式 访问 MCP 工具。 见 VS 代码 MCP 文件 更多细节.
齐德
添加到您的 Zed 设置( E)~/.config/zed/settings.json:
{
"context_servers": {
"air": {
"command": "npx",
"args": ["-y", "@air/mcp"],
"env": {
"AIR_API_KEY": "your-api-key",
"AIR_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
见 Zed MCP 文档 更多细节.
ChatGPT 桌面 (HTTP/ SSE)
ChatGPT桌面不支持STDIO MCP服务器——它只通过HTTP支持MCP. 要连接到本地运行的 Air MCP 服务器 :
- 克隆此还原,安装依赖,并创建
.env文件(参见.env.example:
AIR_API_KEY=your-api-key
AIR_WORKSPACE_ID=your-workspace-id
# AIR_API_URL=https://api.air.inc/v1 # optional, override for non-production environments
- 启动 HTTP 服务器 :
npm run dev:http
- 在 ChatGPT 中, 打开 设置 – 连接器 – 添加连接器。 。 。 .
- 将 URL 设定为 :
http://localhost:3000/mcp
- 设置认证到 无 并拯救我们.
说明: ChatGPT MCP 支持需要 开发者模式 ,目前可通过Windows和网络获取. macOS 支持可能有限——见 ChatGPT MCP 文档 这是最新消息.
可用工具
资产
| 工具 | 说明 |
|---|---|
list_assets | 使用过滤器( 棋盘、 标签、 搜索、 自定义字段) 列出资产 |
list_nested_assets | 在棋盘及其嵌入子棋盘中列出所有资产 |
get_asset | 获取详细资产信息,包括封面版本和元数据 |
get_asset_download_url | 获取资产版本的临时下载 URL |
get_asset_boards | 列出所有含有资产的董事会 |
get_asset_image | 获取资产内置图像预览( Base64) |
rename_asset | 重命名资产的封面版本标题 |
update_asset | 更新资产的显示标题和/或描述 |
add_tag_to_asset | 在资产版本中添加标签 |
remove_tag_from_asset | 从资产版本中删除标签 |
update_asset_custom_field | 在资产上设置自定义字段值 |
董事会
| 工具 | 说明 |
|---|---|
list_boards | 列表板,可选用名称或父过滤 |
get_board | 获取详细的棋盘信息 |
create_board | 创建新棋盘 |
update_board | 更新棋盘的标题、描述或父目录 |
add_asset_to_board | 将资产添加到棋盘中 |
标记
| 工具 | 说明 |
|---|---|
list_tags | 列表标签, 可选用名称过滤 |
create_tag | 创建新标签 |
自定义字段
| 工具 | 说明 |
|---|---|
list_custom_fields | 列出工作空间中的自定义字段 |
get_custom_field | 获取自定义字段细节,包括类型和可能的值 |
发展
# Clone and install
git clone https://github.com/AirInc/air-mcp.git
cd air-mcp
npm install
# Create .env with your credentials
cp .env.example .env
# Run in dev mode (STDIO)
npm run dev
# Run in dev mode (HTTP/SSE)
npm run dev:http
# Run unit tests
npm test
# Run end-to-end tests (requires AIR_API_KEY + AIR_WORKSPACE_ID in .env.test)
npm run test:e2e
# Typecheck
npm run typecheck
# Lint & format
npm run lint
npm run format
# Inspect with MCP Inspector
npm run inspect