에어테이블 MCP

AI 도구를 Airtable에 직접 연결하세요. 자연어를 사용하여 레코드를 쿼리, 생성, 업데이트 및 삭제할 수 있습니다. Cursor, Claude Code, Cline, Zed 및 기타 Claude 기반 편집기와 호환되는 표준화된 MCP 인터페이스를 통해 기반 관리, 테이블 작업, 스키마 조작, 레코드 필터링 및 데이터 마이그레이션 등의 기능을 제공합니다.

이 애플리케이션은 Anthropic의 Model Context Protocol(MCP)을 통해 AI 기반 애플리케이션이 IDE에서 직접 Airtable 데이터에 액세스하고 조작할 수 있도록 하는 강력한 Airtable 통합 도구입니다.

특징

기지 관리 : Airtable 기지 목록 및 선택
테이블 작업 : 테이블, 필드 및 레코드 탐색
데이터 액세스 : 레코드 읽기, 생성, 업데이트 및 삭제
스키마 관리 : 스키마 내보내기, 비교 및 업데이트
명령줄 구성 : 명령줄 매개변수를 통해 API 토큰을 직접 사용
NPX 호환 : 단일 명령으로 간편한 설치
Smithery 통합 : Smithery를 통한 원클릭 설치

건축학

Airtable 데이터에 액세스하고 조작하는 데 사용되는 핵심 구성 요소는 두 가지입니다.

Airtable MCP 서버 : AI 클라이언트가 Airtable과 상호 작용할 수 있는 표준화된 도구를 제공하는 Python 서버입니다.
MCP 클라이언트 : 모델 컨텍스트 프로토콜(Cursor, Claude Desktop, Cline, Zed 등)을 지원하는 모든 클라이언트입니다.

지엑스피1

모델 컨텍스트 프로토콜(MCP)은 Anthropic AI 모델에서 지원하는 기능으로, 호환되는 모든 클라이언트에 대한 사용자 지정 도구를 만들 수 있도록 합니다. Claude Desktop, Cursor, Cline, Zed와 같은 MCP 클라이언트는 MCP 서버를 실행하여 클라이언트에게 사용 가능한 새로운 도구에 대해 "교육"할 수 있습니다.

설치

필수 조건

노드.js 14+
Python 3.10+ (자동 감지)
Airtable API 토큰
호환되는 MCP 클라이언트(Cursor, Claude Desktop 등)

Smithery 설치(권장)

설치하는 가장 쉬운 방법:

스미서리 를 방문하세요
"@rashidazarang/airtable-mcp"를 검색하세요
"설치"를 클릭하고 지시를 따르세요

NPX를 사용한 빠른 설정(대안)

시작하는 또 다른 빠른 방법:

# Install globally
npm install -g airtable-mcp

# Or run directly with npx
npx airtable-mcp --token "your_airtable_token" --base "your_base_id"

MCP 클라이언트 구성

커서의 경우 ~/.cursor/mcp.json 파일을 업데이트하세요.

{
  "mcpServers": {
    "airtable-tools": {
      "command": "npx",
      "args": [
        "airtable-mcp",
        "--token", "your_airtable_token",
        "--base", "your_base_id"
      ]
    }
  }
}

새로운 도구를 로드하려면 MCP 클라이언트를 다시 시작하세요.

수동 설치(고급)

저장소를 복제하고 수동으로 설치하려면 다음을 수행하세요.

이 저장소를 복제하세요:
git clone https://github.com/rashidazarang/airtable-mcp.git cd airtable-mcp
종속성 설치:
pip install -r requirements.txt
서버를 실행합니다:
python airtable_mcp/src/server.py --token "your_airtable_token" --base "your_base_id"

용법

설치 및 구성이 완료되면 자연어를 사용하여 Airtable 데이터와 상호 작용할 수 있습니다.

"내가 접근할 수 있는 모든 기지를 보여주세요"
"현재 기지에 있는 테이블들을 나열하세요"
"고객 테이블의 구조를 보여주세요"
"Orders 테이블에서 처음 10개 레코드를 가져옵니다"
"제품 테이블에 새 레코드를 만듭니다"
"재고 테이블의 레코드 XYZ 업데이트"
"현재 기지의 스키마를 내보냅니다"

사용 가능한 도구

도구 이름	설명
`list_bases`	접근 가능한 모든 Airtable 베이스를 나열하세요
`list_tables`	지정된 기준 또는 기본 기준의 모든 테이블을 나열합니다.
`list_records`	선택적 필터링을 사용하여 테이블의 레코드 나열
`get_record`	테이블에서 특정 레코드 가져오기
`create_records`	JSON 문자열에서 테이블에 레코드 생성
`update_records`	JSON 문자열에서 테이블의 레코드 업데이트
`delete_records`	ID로 테이블에서 레코드 삭제
`export_records`	테이블에서 레코드를 JSON 문자열로 내보내기
`import_records`	JSON 문자열에서 테이블로 레코드 가져오기
`create_tables`	JSON 스키마에서 테이블 생성
`update_schema`	JSON 스키마와 일치하도록 기존 테이블 업데이트
`set_base_id`	현재 Airtable 기반 ID를 설정합니다.
`inspect_table`	테이블 구조 및 필드에 대한 자세한 정보를 얻으세요
`export_schema`	현재 기지의 스키마를 JSON 또는 CSV 형식으로 내보냅니다.
`compare_schemas`	제공된 스키마를 현재 기본 스키마와 비교합니다.
`generate_field_mapping`	두 테이블 간 필드 매핑 생성
`migrate_data`	지정된 필드 매핑을 사용하여 한 테이블에서 다른 테이블로 데이터 마이그레이션

PM2 구성

프로덕션 용도로 PM2를 사용하여 Airtable MCP 서버를 관리할 수 있습니다.

// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'airtable-mcp',
      script: 'npx',
      args: [
        'airtable-mcp',
        '--token', 'your_airtable_token',
        '--base', 'your_base_id'
      ],
      interpreter: '/usr/local/bin/node',
      env: {
        PATH: process.env.PATH,
      },
    },
  ],
};

다음으로 시작하세요:

pm2 start ecosystem.config.js

호환성

모든 MCP 호환 클라이언트와 함께 작동합니다.
주로 Cursor IDE 통합을 위해 설계되었습니다.
다른 AI 편집기 및 MCP 클라이언트를 지원합니다.

자세한 문서

자세한 설치 지침, 문제 해결 및 고급 구성에 대해서는 INSTALLATION.md를 참조하세요.

특허

MIT

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

Integrations