Skip to main content

MCP server for Redis API with 21+ AI parsers (Perplexity, ChatGPT, Claude, etc.)

Project description

ayga-mcp-client

MCP server for Redis API with 21 AI parsers across 5 categories.

mcp-name: io.github.ozand/ayga-mcp-client

✨ What's New in v1.1.0

  • 21 parsers total (was 11): Full sync with redis_wrapper
  • YouTube parsers (6): Video metadata, search, suggestions, channel info, comments
  • Translation services (4): Google, DeepL, Bing, Yandex with language control
  • Social media (4): Telegram groups, Reddit posts/comments
  • Extended parameters: Presets, languages, pagination, sorting
  • Correct tool naming: search_*, parse_*, translate_*, get_*, scrape_*, fetch_*

Quick Start

pip install ayga-mcp-client

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json (Linux/macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ayga": {
      "command": "python",
      "args": ["-m", "ayga_mcp_client"],
      "env": {
        "REDIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code Copilot

Add to your MCP config file (%APPDATA%\Code\User\mcp.json on Windows):

{
  "servers": {
    "ayga": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "ayga_mcp_client"],
      "env": {
        "REDIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Documentation

  • EXAMPLES.md - Detailed examples with request/response formats for all tools
  • DEVELOPMENT.md - Technical architecture and development guide
  • CHANGELOG.md - Version history and release notes

Available Tools

FreeAI Parsers (6)

  • search_perplexity - AI-powered search with sources
  • search_googleai - Google AI search with structured sources
  • search_chatgpt - ChatGPT with web search
  • search_kimi - Kimi AI for translation and education
  • search_deepai - DeepAI multi-style chat
  • search_copilot - Microsoft Copilot search

YouTube Parsers (6)

  • parse_youtube_video - Video metadata, subtitles, comments
  • search_youtube_search - Search videos by keywords
  • get_youtube_suggest - Keyword suggestions/autocomplete
  • get_youtube_channel_videos - List channel videos
  • get_youtube_channel_about - Channel info from About page
  • parse_youtube_comments - Parse video comments with threading

Social Media Parsers (4)

  • scrape_telegram_group - Scrape public group messages
  • search_reddit_posts - Search Reddit posts
  • get_reddit_post_info - Get post with comments
  • search_reddit_comments - Search Reddit comments

Translation Services (4)

  • translate_google_translate - Google Translate (100+ languages)
  • translate_deepl_translate - DeepL high-quality translation
  • translate_bing_translate - Microsoft Bing Translator
  • translate_yandex_translate - Yandex Translate with captcha bypass

Net Parsers (1)

  • fetch_http - Fetch raw URL content

Metadata Tools

  • list_parsers - List all available parsers
  • get_parser_info - Get parser details
  • health_check - API health status

Authentication

Get your API key from https://redis.ayga.tech or contact support@ayga.tech

The client automatically exchanges your API key for a JWT token on first request.

Example Usage

Once configured, use tools in Claude Desktop or VS Code Copilot:

# FreeAI search
@ayga search_perplexity query="latest AI trends 2025" timeout=90
@ayga search_chatgpt query="explain quantum computing" timeout=60

# YouTube parsing
@ayga parse_youtube_video query="https://youtube.com/watch?v=..." preset="default"
@ayga search_youtube_search query="python tutorial" pages_count=2

# Translation with language control
@ayga translate_google_translate query="Hello world" from_language="en" to_language="ru"
@ayga translate_deepl_translate query="Machine learning" to_language="de"

# Social media scraping
@ayga search_reddit_posts query="python" pages_count=1 sort="top"
@ayga scrape_telegram_group query="https://t.me/publicgroup"

# Metadata
@ayga list_parsers
@ayga get_parser_info parser_id="youtube_video"

Environment Variables

Development

git clone https://github.com/ozand/ayga-mcp-client.git
cd ayga-mcp-client
pip install -e ".[dev]"

# Run tests
pytest

# Run locally
python -m ayga_mcp_client --username USER --password PASS

License

MIT License - see LICENSE

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ayga_mcp_client-1.1.0.tar.gz (21.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ayga_mcp_client-1.1.0-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file ayga_mcp_client-1.1.0.tar.gz.

File metadata

  • Download URL: ayga_mcp_client-1.1.0.tar.gz
  • Upload date:
  • Size: 21.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.11

File hashes

Hashes for ayga_mcp_client-1.1.0.tar.gz
Algorithm Hash digest
SHA256 007e85f365fa6bcb48b5e47c2a1a07a19cb26119893c1aff7323903ead02584f
MD5 ce0d786b5fa9e04936231437910b02cd
BLAKE2b-256 924808205c0dcdae02ad6d1ae848fc703f4c004e79f33a01b11f5af3340dcd16

See more details on using hashes here.

File details

Details for the file ayga_mcp_client-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ayga_mcp_client-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8cae40134565348eccd444852bd024ac2bc2b6b67b598ea07f87c94f61b0f84
MD5 f4c37984335117f5a8664ac669e3e463
BLAKE2b-256 c56cba0fe58e14587b879f9138cf7036158d8454a34d391f507fce7df55d9834

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page