AgentQL

AgentQL MCP Sunucusu

Bu, AgentQL'in veri çıkarma yeteneklerini entegre eden bir Model Bağlam Protokolü (MCP) sunucusudur.

Özellikler

Araçlar

• extract-web-data - verilen bir 'url'den, çıkarılacak gerçek veriyi ve alanlarını tanımlayan 'prompt'u kullanarak yapılandırılmış veri çıkarır.

Kurulum

Web sayfalarından veri çıkarmak için AgentQL MCP Sunucusu'nu kullanmak üzere, npm aracılığıyla kurmanız, Dev Portal'ımızdan bir API anahtarı almanız ve MCP'yi destekleyen favori uygulamanızda yapılandırmanız gerekir.

Paketi yükleyin

npm install -g agentql-mcp

Claude'u Yapılandırma

• Claude Masaüstü Ayarlar'ını ⌘+, ile açın (Claude Hesap Ayarları ile karıştırmayın)
• Geliştirici kenar çubuğu bölümüne gidin
• Yapılandırmayı Düzenle'ye tıklayın ve claude_desktop_config.json dosyasını açın
• Yapılandırma dosyasındaki mcpServers sözlüğüne agentql sunucusunu ekleyin
• Uygulamayı yeniden başlatın

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude'ta MCP yapılandırması hakkında daha fazla bilgiyi buradan okuyabilirsiniz.

VS Code'u Yapılandırma

Tek tıkla kurulum için aşağıdaki kurulum düğmelerinden birine tıklayın:

Manuel Kurulum

En hızlı kurulum yöntemi için bu bölümün üst kısmındaki kurulum düğmelerine tıklayın. Manuel kurulum için şu adımları izleyin:

VS Code'da Kullanıcı Ayarları (JSON) dosyanıza aşağıdaki JSON bloğunu ekleyin. Bunu Ctrl + Shift + P tuşuna basıp Preferences: Open User Settings (JSON) yazarak yapabilirsiniz.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "AgentQL API Key",
        "password": true
      }
    ],
    "servers": {
      "agentql": {
        "command": "npx",
        "args": ["-y", "agentql-mcp"],
        "env": {
          "AGENTQL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

İsteğe bağlı olarak, çalışma alanınızda .vscode/mcp.json adlı bir dosyaya ekleyebilirsiniz. Bu, yapılandırmayı başkalarıyla paylaşmanıza olanak tanır.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "AgentQL API Key",
      "password": true
    }
  ],
  "servers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Cursor'ı Yapılandırma

• Cursor Ayarları'nı açın
• MCP > MCP Sunucuları'na gidin
• + Yeni MCP Sunucusu Ekle'ye tıklayın
• Aşağıdakileri girin:
  • Ad: "agentql" (veya tercih ettiğiniz ad)
  • Tür: "command"
  • Komut: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Cursor'da MCP yapılandırması hakkında daha fazla bilgiyi buradan okuyabilirsiniz.

Windsurf'ü Yapılandırma

• Windsurf: MCP Yapılandırma Paneli'ni açın
• Özel sunucu ekle+'ye tıklayın
• Alternatif olarak doğrudan ~/.codeium/windsurf/mcp_config.json dosyasını açabilirsiniz
• Yapılandırma dosyasındaki mcpServers sözlüğüne agentql sunucusunu ekleyin

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf'te MCP yapılandırması hakkında daha fazla bilgiyi buradan okuyabilirsiniz.

MCP Entegrasyonunu Doğrulama

Aracınıza web'den veri çıkarmayı gerektirecek bir görev verin. Örneğin:

Extract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.

[!İPUCU] Aracınızın AgentQL kullanmak yerine URL'leri açamadığından veya web'den içerik yükleyemediğinden şikayet etmesi durumunda, "araçları kullan" veya "agentql aracını kullan" ipucunu eklemeyi deneyin.

Geliştirme

Bağımlılıkları yükleyin:

npm install

Sunucuyu derleyin:

npm run build

Otomatik yeniden derleme ile geliştirme için:

npm run watch

Geliştirme sürümünü denemek isterseniz, varsayılan yapılandırma yerine aşağıdaki yapılandırmayı kullanabilirsiniz:

{
  "mcpServers": {
    "agentql": {
      "command": "/path/to/agentql-mcp/dist/index.js",
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

[!NOT] Claude'u iki benzer sunucuyla karıştırmamak için varsayılan AgentQL MCP sunucu yapılandırmasını kaldırmayı unutmayın.

Hata Ayıklama

MCP sunucuları stdio üzerinden iletişim kurduğundan, hata ayıklama zor olabilir. Bir paket betiği olarak sunulan MCP Inspector'ı kullanmanızı öneririz:

npm run inspector

Inspector, tarayıcınızda hata ayıklama araçlarına erişmek için bir URL sağlayacaktır.