AgentQL MCP Server

Bu, AgentQL'ın veri çıkarma yeteneklerini entegre eden bir Model Context Protocol (MCP) sunucusudur.

Özellikler

Tools

• extract-web-data - belirli bir 'url'den yapılandırılmış veri çıkarır, çıkarılacak gerçek verinin ve alanlarının açıklaması olarak 'prompt' kullanır.

Kurulum

Web sayfalarından veri çıkarmak için AgentQL MCP Server'ı kullanmak üzere, npm aracılığıyla kurmanız, Dev Portal'dan bir API anahtarı almanız ve bunu MCP'yi destekleyen en sevdiğiniz uygulamada yapılandırmanız gerekir.

Paketi yükleyin

npm install -g agentql-mcp

Claude'u yapılandırın

• Claude Desktop Settings'i ⌘+, tuşlarıyla açın (Claude Account Settings ile karıştırmayın)
• Developer kenar çubuğu bölümüne gidin
• Edit Config'e tıklayın ve claude_desktop_config.json dosyasını açın
• Config dosyasındaki mcpServers sözlüğünün içine agentql sunucusunu ekleyin
• Uygulamayı yeniden başlatın

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

Claude'da MCP yapılandırması hakkında daha fazla bilgi için buraya bakın.

VS Code'u yapılandırın

Tek tıklamalı 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 en üstündeki kurulum düğmelerine tıklayın. Manuel kurulum için şu adımları izleyin:

Aşağıdaki JSON bloğunu VS Code'da User Settings (JSON) dosyanıza ekleyin. Bunu Ctrl + Shift + P tuşlarına basarak ve 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, bunu ç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'u yapılandırın

• Cursor Settings'i açın
• MCP > MCP Servers'a gidin
• + Add new MCP Server'a tıklayın
• Aşağıdakileri girin:
  • Name: "agentql" (veya tercih ettiğiniz ad)
  • Type: "command"
  • Command: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Cursor'da MCP yapılandırması hakkında daha fazla bilgi için buraya bakın.

Windsurf'u yapılandırın

• Windsurf: MCP Configuration Panel'i açın
• Add custom server+'a tıklayın
• Alternatif olarak ~/.codeium/windsurf/mcp_config.json dosyasını doğrudan açabilirsiniz
• Config dosyasındaki mcpServers sözlüğünün içine agentql sunucusunu ekleyin

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

Windsurf'da MCP yapılandırması hakkında daha fazla bilgi için buraya bakın.

MCP entegrasyonunu doğrulayın

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

https://www.youtube.com/results?search_query=agentql sayfasından videoların listesini çıkarın, her video bir başlık, yazar adı, görüntüleme sayısı ve video URL'si içermelidir. Reklam öğelerini hariç tuttuğunuzdan emin olun. Bunu bir markdown tablosu olarak biçimlendirin.

[!TIP] Eğer ajanınız AgentQL yerine URL'leri açamadığından veya web'den içerik yükleyemediğinden şikayet ederse, "use tools" veya "use agentql tool" ipucu 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 istiyorsanız, 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"
      }
    }
  }
}

[!NOTE] Claude'u iki benzer sunucu ile karıştırmamak için varsayılan AgentQL MCP sunucusu 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 script olarak kullanılabilen 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.