Databases TypeScript ★ 85

rashidazarang/airtable-mcp

Airtable'ı doğrudan AI araçlarına bağlayın. Doğal dil kullanarak kayıtları sorgulayın, oluşturun, güncelleyin ve silin. Base yönetimi, tablo işlemleri, schema manipülasyonu, kayıt filtreleme ve standartlaştırılmış MCP interface aracılığıyla veri taşıma özellikleri sunur.

Claude Desktop config.json'a ekle

{
  "mcpServers": {
    "rashidazarang-airtable-mcp": {
      "command": "node",
      "args": [
        "~/.mcp/airtable-mcp/index.js"
      ]
    }
  }
}

Bu MCP sunucusu hakkında

Airtable MCP Sunucusu

Trust Score smithery badge Airtable MCP TypeScript AI Agent Security Protocol

Airtable için Model Context Protocol (MCP) sunucusu; tam CRUD işlemleri, schema yönetimi, kayıt yorumları, webhook'lar, toplu işlemler, yönetişim kontrolleri ve AI destekli analitikler sunar.

Sürüm 4.0.0 | MCP Protocol 2024-11-05 | npm

Hızlı Başlangıç (Claude Desktop)

Kurulum gerekmiyor — bunu Claude Desktop yapılandırmanıza eklemeniz yeterli ve yeniden başlatın:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "@rashidazarang/airtable-mcp"],
      "env": {
        "AIRTABLE_TOKEN": "YOUR_AIRTABLE_TOKEN",
        "AIRTABLE_BASE_ID": "YOUR_BASE_ID"
      }
    }
  }
}

Bu kadar. npx sunucuyu otomatik olarak indirir ve çalıştırır. git clone yok, npm install yok.

Token'ınızı alın airtable.com/create/tokens adresinde — aşağıdaki Token Kapsamları bölümünde listelenen tüm kapsamları verin. Base ID'nizi alın base'i görüntülerken URL'den: https://airtable.com/[BASE_ID]/... (veya atladığınız base'leri dinamik olarak keşfetmek için list_bases kullanın).

Hızlı Başlangıç (Claude Code)

Tek komutla kurulum

curl -fsSL https://raw.githubusercontent.com/rashidazarang/airtable-mcp/main/setup.sh | bash

Betik ön koşulları kontrol eder, Airtable token'ınızı ister ve MCP yapılandırmasını ~/.claude.json dosyasına yazar. Claude Code'u yeniden başlatın (veya /mcp çalıştırın) bağlantı kurmak için.

Token'ınızı doğrudan da geçirebilirsiniz:

curl -fsSL https://raw.githubusercontent.com/rashidazarang/airtable-mcp/main/setup.sh | bash -s -- YOUR_AIRTABLE_TOKEN

Manuel yapılandırma

~/.claude.json dosyasında mcpServers altına ekleyin:

{
  "airtable": {
    "type": "stdio",
    "command": "/bin/bash",
    "args": ["-c", "cd /tmp && npx -y @rashidazarang/airtable-mcp"],
    "env": {
      "AIRTABLE_TOKEN": "YOUR_AIRTABLE_TOKEN"
    }
  }
}

Neden bash sarmalayıcısı? npx, aynı paket adını içeren bir package.json içeren bir dizinden çalıştırıldığında binary'yi çözemez. cd /tmp && öneki bu uç durumu önler.

Genel Bakış

Bu sunucu, Model Context Protocol aracılığıyla kapsamlı Airtable entegrasyonu sağlar ve Airtable verilerinizle doğal dil etkileşimlerini mümkün kılar. 42 araç ve 10 AI prompt şablonu içerir.

Temel Özellikler

  • Tam CRUD İşlemleri — Filtreleme ve sayfalandırma ile kayıtları oluşturun, okuyun, güncelleyin ve silin
  • Kayıt Yorumları — Kayıtlar üzerinde yorumları listeleyin, oluşturun, güncelleyin ve silin
  • Schema Yönetimi — Tabloları, alanları ve görünümleri programlı olarak oluşturun ve değiştirin
  • Toplu İşlemler — İyileştirilmiş performans için işlem başına 10 kaydı işleyin
  • Webhook Yönetimi — Veri değişiklikleri için gerçek zamanlı bildirimler ayarlayın
  • Yönetişim ve Uyum — İzin listesi yönetişimi, PII maskeleme ve istisna izleme
  • Kullanıcı Kimliği — whoami aracıyla token kimliğini doğrulayın
  • AI Analitikleri — Tahmine dayalı analitik, doğal dil sorguları ve otomatik içgörüler için 10 prompt şablonu
  • Çoklu Base Desteği — Birden fazla base'i dinamik olarak keşfedin ve kullanın
  • Tür Güvenliği — Kapsamlı tür tanımlamalarıyla tam TypeScript desteği

Ön Koşullar

  • Node.js 18 veya üstü
  • Personal Access Token'ı olan Airtable hesabı
  • Airtable Base ID'niz (isteğe bağlı — list_bases aracı aracılığıyla keşfedilebilir)

Token Kapsamları

airtable.com/create/tokens adresinde şu kapsamlarla Personal Access Token oluşturun:

Kapsam Amaç
data.records:read Kayıtları okuyun
data.records:write Kayıtları oluşturun, güncelleyin, silin
data.recordComments:read Kayıt yorumlarını okuyun
data.recordComments:write Yorumları oluşturun, güncelleyin, silin
schema.bases:read Tablo şemalarını görüntüleyin
schema.bases:write Tabloları ve alanları oluşturun ve değiştirin
user.email:read Kullanıcı kimliğini okuyun (whoami)
webhook:manage Webhook'ları yönetin (isteğe bağlı)

Kullanım

Yapılandırıldıktan sonra, Airtable verilerinizle doğal dil kullanarak etkileşime geçin:

Temel İşlemler

  • "Tüm erişilebilir Airtable base'lerimi listele"
  • "Bana Projects tablosundaki tüm kayıtları göster"
  • "Önceliği 'Yüksek' ve bitiş tarihi yarın olan yeni bir görev oluştur"
  • "rec123 task ID'sinin durumunu 'Tamamlandı' olarak güncelleyin"
  • "Durumu 'Aktif' olan kayıtları arayın"

Schema Yönetimi

  • "Bu base için tam şemayı göster"
  • "Name, Priority ve Due Date alanlarıyla 'Tasks' adlı yeni bir tablo oluştur"
  • "Projects tablosuna Status alanı ekle"

Kayıt Yorumları

  • "rec123 kaydının tüm yorumlarını göster"
  • "Bu kaydına yorum ekle: 'İncelendi ve onaylandı'"
  • "Yorumumu 'Revizyon gerekli' olarak güncelleyin"

Toplu İşlemler

  • "Tasks tablosunda aynı anda 5 yeni kayıt oluştur"
  • "Birden fazla kaydı yeni durum değerleriyle güncelleyin"
  • "Bu 3 kaydı tek bir işlemde silin"

Webhook'lar

  • "Base'imdeki tüm etkin webhook'ları listele"
  • "Projects tablosundaki değişikliklere yönelik webhook oluştur"

Mevcut Araçlar (42)

Temel İşlemler (4 araç)

Araç Açıklama
list_bases Tüm erişilebilir base'leri izinlerle birlikte listeleyin
describe Base veya tablo şemasını açıklayın (detay seviyelerini destekler)
query Filtreleme, sıralama ve sayfalandırmayla sorguyu çalıştırın
search_records Airtable formülleriyle gelişmiş arama

Kayıt CRUD (5 araç)

Araç Açıklama
list_records Alan seçimi ve sayfalandırmayla kayıtları listeleyin
get_record Tek bir kaydı ID'ye göre alın
create Yeni kayıtlar oluşturun (dryRun fark incelemesi gerekir)
update Mevcut kayıtları güncelleyin (dryRun fark incelemesi gerekir)
delete_record Bir kaydı tablodan kaldırın

Upsert (2 araç)

Araç Açıklama
upsert Merge alanlarına göre kayıtları güncelleyin veya oluşturun
batch_upsert_records Merge-on alanlarıyla toplu upsert

Schema Keşfi (4 araç)

Araç Açıklama
list_tables Base'deki tüm tabloları şema bilgisiyle alın
get_base_schema Herhangi bir base için tam şemayı alın
list_field_types Mevcut alan türleri için başvuru kılavuzu
get_table_views Bir tablo için tüm görünümleri listeleyin

Tablo Yönetimi (3 araç)

Araç Açıklama
create_table Özel alan tanımlamalarıyla tablolar oluşturun
update_table Tablo adlarını ve açıklamalarını değiştirin
delete_table Tabloları kaldırın (onay gerekir)

Alan Yönetimi (3 araç)

Araç Açıklama
create_field Mevcut tablolara alanlar ekleyin
update_field Alan özelliklerini ve seçeneklerini değiştirin
delete_field Alanları kaldırın (onay gerekir)

Toplu İşlemler (3 araç)

Araç Açıklama
batch_create_records Aynı anda 10 kaydı oluşturun
batch_update_records 10 kaydı aynı anda güncelleyin
batch_delete_records Bir işlemde 10 kaydı silin

Webhook Yönetimi (5 araç)

Araç Açıklama
list_webhooks Yapılandırılmış tüm webhook'ları görüntüleyin
create_webhook Gerçek zamanlı bildirimler ayarlayın
delete_webhook Webhook yapılandırmalarını kaldırın
get_webhook_payloads Bildirim geçmişini alın
refresh_webhook Webhook süresini uzatın

Görünümler ve Ek Dosyalar (3 araç)

Araç Açıklama
create_view Görünümler oluşturun (grid, form, calendar, vb.)
get_view_metadata Filtreleri içeren görünüm ayrıntılarını alın
upload_attachment URL'lerden dosyalar ekleyin

Base Yönetimi (3 araç)

Araç Açıklama
create_base İlk yapıyla yeni base'ler oluşturun
list_collaborators İşbirlikçileri ve izinleri görüntüleyin
list_shares Paylaşılan görünümleri ve yapılandırmaları listeleyin

Kayıt Yorumları (4 araç)

Araç Açıklama
list_comments Bir kayıttaki yorumları listeleyin
create_comment Bir kaydına yorum ekleyin
update_comment Mevcut bir yorumu düzenleyin
delete_comment Bir yorumu kaldırın

Kullanıcı Bilgisi (1 araç)

Araç Açıklama
whoami Geçerli kullanıcı kimliğini ve kapsamlarını alın

Yönetişim ve Yönetim (2 araç)

Araç Açıklama
list_governance Yönetişim izin listelerini ve PII maskeleme ilkelerini döndürün
list_exceptions Son istisnalar ve düzeltme önerilerini listeleyin

AI Zeka Paketi

Gelişmiş analitikler için on AI prompt şablonu:

Prompt Açıklama
analyze_data Anomali tespiti içeren istatistiksel analiz
create_report Akıllı rapor oluşturma
data_insights İş zekası ve desen keşfi
optimize_workflow Otomasyon önerileri
smart_schema_design Veritabanı optimizasyonu önerileri
data_quality_audit Kalite değerlendirmesi ve düzeltme
predictive_analytics Tahminleme ve trend tahmini
natural_language_query Bağlam farkındalığıyla soruları işleyin
smart_data_transformation AI destekli veri işleme
automation_recommendations Maliyet-fayda analiziyle iş akışı optimizasyonu

Gelişmiş Yapılandırma

Smithery Cloud

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "@smithery/cli",
        "run",
        "@rashidazarang/airtable-mcp"
      ],
      "env": {
        "AIRTABLE_TOKEN": "YOUR_TOKEN",
        "AIRTABLE_BASE_ID": "YOUR_BASE_ID"
      }
    }
  }
}

Ortam Değişkenleri

Değişken Gerekli Açıklama
AIRTABLE_TOKEN Evet Personal Access Token
AIRTABLE_BASE_ID Hayır Varsayılan base ID'si (list_bases aracılığıyla keşfedilebilir)
LOG_LEVEL Hayır Günlük düzeyi (varsayılan: info)
MCP_HTTP_PORT Hayır Barındırılan dağıtımlar için HTTP aktarımını etkinleştirin

Geliştirme

Kullanıcılar için gerekli değildir. Depoyu yalnızca katkıda bulunmak veya sunucuyu değiştirmek istiyorsanız klonlayın. Son kullanıcılar yukarıdaki Hızlı Başlangıç bölümlerinde gösterildiği gibi npx kullanmalıdır.

git clone https://github.com/rashidazarang/airtable-mcp.git
cd airtable-mcp
npm install
npm run build

Test Etme

npm run test:types     # Tür kontrolü
npm test               # Test paketini çalıştırın

Proje Yapısı

airtable-mcp/
├── src/typescript/          # TypeScript uygulaması
│   ├── app/
│   │   ├── tools/           # 42 araç uygulaması
│   │   ├── prompts/         # 10 AI prompt kaydı
│   │   ├── airtable-client.ts
│   │   ├── governance.ts
│   │   └── context.ts
│   └── airtable-mcp-server.ts
├── dist/                    # Derlenmiş çıktı
├── docs/                    # Belgeler
├── types/                   # TypeScript tanımları
└── bin/                     # CLI yürütülebilirleri

Sorun Giderme

Bağlantı Sorunları

  • MCP sunucusunun çalıştığını doğrulayın
  • MCP istemcinizi yeniden başlatın
  • Token'ınızın gerekli kapsamları aldığını kontrol edin

Geçersiz Token

  • Personal Access Token'ınızın doğru olduğunu doğrulayın
  • Token'ınızın gerekli kapsamları aldığını onaylayın
  • Kimlik bilgilerinde fazla boşluk olup olmadığını kontrol edin

Base Bulunamadı

  • Base ID'nizi kontrol edin
  • Token'ınızın base'e erişimi olduğunu doğrulayın
  • Erişilebilir base'leri keşfetmek için list_bases kullanın

Belgeler

Katkıda Bulunma

Katkılar hoş karşılanır. Lütfen büyük değişiklikleri tartışmak için önce bir sorun açın.

Lisans

MIT Lisansı — ayrıntılar için LICENSE dosyasını görüntüleyin.

Destek

Benzer MCP sunucuları

googleapis/genai-toolbox Databases

Veritabanları için kolay, hızlı ve güvenli araçlar sağlayan açık kaynak MCP sunucusu.

googleapis/genai-toolbox ★ 15,682
baserow/baserow Databases

Baserow veritabanı entegrasyonu ile tablo arama, listeleme ve satır oluşturma, okuma, güncelleme ve silme işlemlerini gerçekleştirebilirsiniz.

baserow/baserow ★ 5,128
crystaldba/postgres-mcp Databases

Postgres geliştirme ve operasyonları için kapsamlı MCP sunucusu; performans analizi, ayarlama ve sağlık kontrolleri için araçlar içerir.

crystaldba/postgres-mcp ★ 2,947
supabase-community/supabase-mcp Databases

Supabase'in resmi MCP sunucusu, AI asistanlarını doğrudan Supabase projenize bağlayarak tablo yönetimi, config getirme ve veri sorgulama gibi işlemleri gerçekleştirmelerine olanak tanır.

supabase-community/supabase-mcp ★ 2,746
benborla/mcp-server-mysql Databases

NodeJS'de MySQL veritabanı entegrasyonu, yapılandırılabilir erişim kontrolleri ve schema incelemesi özellikleri ile sağlanır.

benborla/mcp-server-mysql ★ 1,855
qdrant/mcp-server-qdrant Databases

A Qdrant MCP server

qdrant/mcp-server-qdrant ★ 1,440
Daha fazla: Databases →