airtable-mcp-server

에어테이블-mcp-서버

Airtable 데이터베이스에 대한 읽기 및 쓰기 권한을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 데이터베이스 스키마를 검사한 후 레코드를 읽고 쓸 수 있습니다.

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

용법

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

지엑스피1

pat123.abc123 Airtable 개인 액세스 토큰 으로 바꾸세요. 토큰에는 최소한 schema.bases:read 및 data.records:read 권한이 있어야 하며, 선택적으로 해당 쓰기 권한이 있어야 합니다.

구성 요소

도구

• 목록_레코드
  • 지정된 Airtable 테이블의 레코드를 나열합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 쿼리할 테이블의 ID
    • maxRecords (숫자, 선택 사항): 반환할 최대 레코드 수입니다. 기본값은 100입니다.
    • filterByFormula (문자열, 선택 사항): 레코드를 필터링하는 Airtable 수식
• 검색_레코드
  • 특정 텍스트가 포함된 레코드 검색
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 쿼리할 테이블의 ID
    • searchTerm (문자열, 필수): 레코드에서 검색할 텍스트
    • fieldIds (배열, 선택 사항): 검색할 특정 필드 ID입니다. 지정하지 않으면 모든 텍스트 기반 필드를 검색합니다.
    • maxRecords (숫자, 선택 사항): 반환할 최대 레코드 수입니다. 기본값은 100입니다.
• 리스트_베이스
  • 접근 가능한 모든 Airtable 베이스를 나열합니다.
  • 입력 매개변수가 필요하지 않습니다
  • 기본 ID, 이름 및 권한 수준을 반환합니다.
• 리스트_테이블
  • 특정 기준에 있는 모든 테이블을 나열합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • detailLevel (문자열, 선택 사항): 테이블에 대한 세부 정보의 양( tableIdentifiersOnly , identifiersOnly 또는 full )
  • 지정된 detailLevel 에 대한 테이블 ID, 이름, 설명, 필드 및 뷰를 반환합니다.
• 설명_테이블
  • 특정 테이블에 대한 자세한 정보를 가져옵니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 설명할 테이블의 ID
    • detailLevel (문자열, 선택 사항): 테이블에 대한 세부 정보의 양( tableIdentifiersOnly , identifiersOnly 또는 full )
  • list_tables와 동일한 형식을 반환하지만 단일 테이블에 대해서만 반환
  • 기본 테이블에 대한 모든 정보를 가져오지 않고도 특정 테이블에 대한 세부 정보를 얻는 데 유용합니다.
• get_record
  • ID로 특정 레코드를 가져옵니다
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • recordId (문자열, 필수): 검색할 레코드의 ID
• 레코드 생성
  • 테이블에 새 레코드를 만듭니다
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • fields (객체, 필수): 새 레코드에 대한 필드 및 값
• 업데이트_레코드
  • 테이블에서 하나 이상의 레코드를 업데이트합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • records (배열, 필수): 레코드 ID와 업데이트할 필드가 포함된 객체 배열
• 레코드 삭제
  • 테이블에서 하나 이상의 레코드를 삭제합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • recordIds (배열, 필수): 삭제할 레코드 ID 배열
• 테이블 생성
  • 기본에 새 테이블을 만듭니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • name (문자열, 필수): 새 테이블의 이름
    • description (문자열, 선택 사항): 테이블에 대한 설명
    • fields (배열, 필수): 필드 정의 배열(이름, 유형, 설명, 옵션)
• 업데이트_테이블
  • 테이블의 이름이나 설명을 업데이트합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • name (문자열, 선택 사항): 테이블의 새 이름
    • description (문자열, 선택 사항): 테이블에 대한 새 설명
• 필드 생성
  • 테이블에 새 필드를 만듭니다
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • name (문자열, 필수): 새 필드의 이름
    • type (문자열, 필수): 필드의 유형
    • description (문자열, 선택 사항): 필드에 대한 설명
    • options (객체, 선택 사항): 필드별 옵션
• 업데이트_필드
  • 필드 이름이나 설명을 업데이트합니다.
  • 입력 매개변수:
    • baseId (문자열, 필수): Airtable 기본 ID
    • tableId (문자열, 필수): 테이블의 ID
    • fieldId (문자열, 필수): 필드의 ID
    • name (문자열, 선택 사항): 필드의 새 이름
    • description (문자열, 선택 사항): 필드에 대한 새 설명

자원

서버는 Airtable 기반과 테이블에 대한 스키마 정보를 제공합니다.

• 테이블 스키마 ( airtable://<baseId>/<tableId>/schema )
  • 각 테이블에 대한 JSON 스키마 정보
  • 포함 사항:
    • 기본 ID와 테이블 ID
    • 테이블 이름 및 설명
    • 기본 필드 ID
    • 필드 정의(ID, 이름, 유형, 설명, 옵션)
    • 정의 보기(ID, 이름, 유형)
  • Airtable의 메타데이터 API에서 자동으로 발견됨

기여하다

GitHub에서 풀 리퀘스트를 환영합니다! 시작하려면:

1. Git과 Node.js 설치
2. 저장소를 복제합니다
3. npm install 로 종속성 설치
4. npm run test 실행하여 테스트를 실행합니다.
5. npm run build 로 빌드하세요

• npm run build:watch 사용하면 src/index.ts 파일을 편집한 후 자동으로 빌드할 수 있습니다. 즉, 저장을 클릭하고 Claude Desktop을 다시 로드하면(Ctrl/Cmd+R) 변경 사항이 적용됩니다.

출시

버전은 의미적 버전 사양을 따릅니다.

해제하려면:

1. npm version <major | minor | patch> 사용하여 버전을 높이세요.
2. 태그와 함께 푸시하려면 git push --follow-tags 실행하세요.
3. GitHub Actions가 NPM 레지스트리에 게시될 때까지 기다리세요.