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 sourcessearch_googleai- Google AI search with structured sourcessearch_chatgpt- ChatGPT with web searchsearch_kimi- Kimi AI for translation and educationsearch_deepai- DeepAI multi-style chatsearch_copilot- Microsoft Copilot search
YouTube Parsers (6)
parse_youtube_video- Video metadata, subtitles, commentssearch_youtube_search- Search videos by keywordsget_youtube_suggest- Keyword suggestions/autocompleteget_youtube_channel_videos- List channel videosget_youtube_channel_about- Channel info from About pageparse_youtube_comments- Parse video comments with threading
Social Media Parsers (4)
scrape_telegram_group- Scrape public group messagessearch_reddit_posts- Search Reddit postsget_reddit_post_info- Get post with commentssearch_reddit_comments- Search Reddit comments
Translation Services (4)
translate_google_translate- Google Translate (100+ languages)translate_deepl_translate- DeepL high-quality translationtranslate_bing_translate- Microsoft Bing Translatortranslate_yandex_translate- Yandex Translate with captcha bypass
Net Parsers (1)
fetch_http- Fetch raw URL content
Metadata Tools
list_parsers- List all available parsersget_parser_info- Get parser detailshealth_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
REDIS_API_KEY- Your API key (required)REDIS_API_URL- API URL (default: https://redis.ayga.tech)
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
007e85f365fa6bcb48b5e47c2a1a07a19cb26119893c1aff7323903ead02584f
|
|
| MD5 |
ce0d786b5fa9e04936231437910b02cd
|
|
| BLAKE2b-256 |
924808205c0dcdae02ad6d1ae848fc703f4c004e79f33a01b11f5af3340dcd16
|
File details
Details for the file ayga_mcp_client-1.1.0-py3-none-any.whl.
File metadata
- Download URL: ayga_mcp_client-1.1.0-py3-none-any.whl
- Upload date:
- Size: 17.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f8cae40134565348eccd444852bd024ac2bc2b6b67b598ea07f87c94f61b0f84
|
|
| MD5 |
f4c37984335117f5a8664ac669e3e463
|
|
| BLAKE2b-256 |
c56cba0fe58e14587b879f9138cf7036158d8454a34d391f507fce7df55d9834
|