Meerkats.Ai Server

This is a Model Context Protocol (MCP) server for the Meerkats.ai web scraping service. It provides tools for web scraping, RSS feed processing, and Google search.

Features

• Web Scraping: Scrape any URL and get the content as markdown
• RSS Feed Processing: Process RSS feeds and get the content
• Google Search: Search Google and get the results

Installation

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Create a .env file based on .env.example and add your Meerkats.ai API key
4. Build the project:

   npm run build
   

Configuration

Add the MCP server to your MCP settings configuration file:

{
  "mcpServers": {
    "meerkats": {
      "command": "node",
      "args": ["path/to/meerkats.ai/build/index.js"],
      "env": {
        "MEERKATS_API_KEY": "your_api_key_here",
        "SCRAPPER_API_URL": "https://api.meerkats.ai",
        "SCRAPPER_CALLBACK_API_URL": "https://api.meerkats.ai/callback"
      }
    }
  }
}

Available Tools

scrape_url

Scrape a URL and return the content as markdown.

Parameters:

• url (required): URL to scrape
• wait (optional): Time to wait in seconds before scraping
• query (optional): Query to search for on the page

rss_feed

Process an RSS feed and return the content.

Parameters:

• url (required): URL of the RSS feed
• wait (optional): Time to wait in seconds before processing

google_search

Search Google and return the results.

Parameters:

• query (required): Query to search for on Google

Example Usage

// Example of using the scrape_url tool
const result = await use_mcp_tool({
  server_name: "meerkats",
  tool_name: "scrape_url",
  arguments: {
    url: "https://example.com",
    wait: 2
  }
});

// Example of using the google_search tool
const searchResult = await use_mcp_tool({
  server_name: "meerkats",
  tool_name: "google_search",
  arguments: {
    query: "meerkats.ai web scraping"
  }
});

License

MIT