@ayga/mcp-client 3.2.0 → 3.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +49 -180
  2. package/package.json +55 -55
package/README.md CHANGED
@@ -1,37 +1,31 @@
1
1
  # Ayga MCP Client (Node.js) v3.2.0
2
2
 
3
- Modern, lightweight MCP client with **6 consolidated AI tools** - optimized for LLM context windows.
3
+ > **Paid Service**: This is a paid Ayga service. Get your API key at [@aygamcp_bot](https://t.me/aygamcp_bot).
4
4
 
5
- ## What's New in v3.2.0
5
+ MCP client with **6 consolidated AI tools** for Claude Desktop and VS Code Copilot.
6
6
 
7
- - **API Key Validation**: Validates `ayga_live_*` key format on startup
8
- - **Rate Limit Checking**: New `ayga_check_limits` tool to check your quota
9
- - **Better Error Messages**: Clear warnings for deprecated key formats
10
-
11
- See [Migration Guide](docs/MIGRATION.md) for upgrading from legacy keys.
12
-
13
- ## What's New in v3.0.0
14
-
15
- **Context-Optimized Architecture**: Reduced from 40+ individual tools to 6 consolidated tools, saving ~80% context tokens while maintaining full functionality.
7
+ ## Quick Start
16
8
 
17
- | Tool | Engines | Default |
18
- |------|---------|---------|
19
- | `ask_ai` | perplexity, chatgpt, claude, gemini, copilot, grok, deepseek, deepai | perplexity |
20
- | `search_web` | google_search, bing_search, duckduckgo, yandex_search, yahoo_search, baidu_search, google_trends, rambler_search, you_search | google_search |
21
- | `get_social` | instagram_profile, instagram_post, instagram_tag, instagram_geo, tiktok_profile, pinterest_search, reddit_posts, reddit_comments | instagram_profile |
22
- | `get_video` | youtube_search, youtube_video, youtube_comments, youtube_channel_videos, youtube_channel_about | youtube_search |
23
- | `translate` | google_translate, bing_translate, yandex_translate | google_translate |
24
- | `extract` | text_extractor, article_extractor, link_extractor | text_extractor |
9
+ 1. Get API key: [@aygamcp_bot](https://t.me/aygamcp_bot) → `/newkey`
10
+ 2. Configure your IDE (see below)
11
+ 3. Use tools: `ask_ai`, `search_web`, `get_video`, `get_social`, `translate`, `extract`
25
12
 
26
- ## Quick Start
13
+ ## Available Tools
27
14
 
28
- ### Install via npx (recommended)
15
+ | Tool | Description | Default Engine |
16
+ |------|-------------|----------------|
17
+ | `ask_ai` | Query AI models | perplexity |
18
+ | `search_web` | Web search and trends | google_search |
19
+ | `get_video` | YouTube content | youtube_search |
20
+ | `get_social` | Social media data | instagram_profile |
21
+ | `translate` | Text translation | google_translate |
22
+ | `extract` | Web page extraction | text_extractor |
23
+ | `ayga_check_limits` | Check your rate limits | - |
24
+ | `list_parsers` | List all available parsers | - |
29
25
 
30
- ```bash
31
- npx @ayga/mcp-client
32
- ```
26
+ ## Configuration
33
27
 
34
- ### VS Code Copilot Configuration
28
+ ### VS Code Copilot
35
29
 
36
30
  Add to `%APPDATA%\Code\User\mcp.json`:
37
31
 
@@ -58,7 +52,7 @@ Add to `%APPDATA%\Code\User\mcp.json`:
58
52
  }
59
53
  ```
60
54
 
61
- ### Claude Desktop Configuration
55
+ ### Claude Desktop
62
56
 
63
57
  Add to `%APPDATA%\Claude\claude_desktop_config.json`:
64
58
 
@@ -76,45 +70,28 @@ Add to `%APPDATA%\Claude\claude_desktop_config.json`:
76
70
  }
77
71
  ```
78
72
 
79
- ## Usage Examples
80
-
81
- ### Basic Usage (uses default engine)
73
+ ## Usage
82
74
 
83
- ```
75
+ ```bash
76
+ # Basic usage (default engine)
84
77
  ask_ai query="What is quantum computing?"
85
78
  search_web query="latest AI news"
86
79
  get_video query="Python tutorials"
87
- translate query="Hello world"
88
- ```
89
-
90
- ### With Specific Engine
91
80
 
92
- ```
81
+ # With specific engine
93
82
  ask_ai query="Explain transformers" engine="claude"
94
- search_web query="weather today" engine="duckduckgo"
95
- get_social query="@openai" engine="instagram_profile"
96
- get_video query="dQw4w9WgXcQ" engine="youtube_video"
97
- ```
98
-
99
- ### With Timeout
83
+ search_web query="weather" engine="duckduckgo"
100
84
 
101
- ```
102
- ask_ai query="Complex analysis" engine="perplexity" timeout=120
85
+ # Check your rate limits
86
+ ayga_check_limits _placeholder=true
103
87
  ```
104
88
 
105
89
  ## Environment Variables
106
90
 
107
- | Variable | Description | Default |
108
- |----------|-------------|---------|
109
- | `REDIS_API_KEY` | API key for authentication | (required) |
110
- | `API_URL` | Backend API URL | https://redis.ayga.tech |
111
- | `DEFAULT_AI_ENGINE` | Default for ask_ai | perplexity |
112
- | `DEFAULT_SEARCH_ENGINE` | Default for search_web | google_search |
113
- | `DEFAULT_SOCIAL_ENGINE` | Default for get_social | instagram_profile |
114
- | `DEFAULT_VIDEO_ENGINE` | Default for get_video | youtube_search |
115
- | `DEFAULT_TRANSLATION_ENGINE` | Default for translate | google_translate |
116
- | `DEFAULT_EXTRACTION_ENGINE` | Default for extract | text_extractor |
117
- | `DYNAMIC_PARSERS` | Enable dynamic parser loading | true |
91
+ | Variable | Required | Default |
92
+ |----------|----------|---------|
93
+ | `REDIS_API_KEY` | Yes | - |
94
+ | `API_URL` | No | https://redis.ayga.tech |
118
95
 
119
96
  ## Architecture
120
97
 
@@ -126,143 +103,35 @@ ask_ai query="Complex analysis" engine="perplexity" timeout=120
126
103
  +-----------------v-------------------+
127
104
  | @ayga/mcp-client (Node.js) |
128
105
  | - 6 consolidated tools |
129
- | - 36 parser engines |
130
- | - JWT authentication |
106
+ | - 40+ parser engines |
131
107
  +-----------------+-------------------+
132
- | HTTPS REST API
108
+ | HTTPS
133
109
  +-----------------v-------------------+
134
- | redis_wrapper (Python/FastAPI) |
135
- | https://redis.ayga.tech |
110
+ | Ayga API (redis.ayga.tech) |
136
111
  +-----------------+-------------------+
137
- | Redis Queue
112
+ |
138
113
  +-----------------v-------------------+
139
- | A-Parser (Windows) |
114
+ | Parser Backend |
140
115
  +-------------------------------------+
141
116
  ```
142
117
 
143
- ## Tool Reference
118
+ ## Available Engines
144
119
 
145
- ### ask_ai
146
- Query AI models for answers, analysis, and research.
120
+ | Tool | Engines |
121
+ |------|---------|
122
+ | `ask_ai` | perplexity, chatgpt, claude, gemini, copilot, grok, deepseek, deepai |
123
+ | `search_web` | google_search, bing_search, duckduckgo, yandex_search, google_trends |
124
+ | `get_video` | youtube_search, youtube_video, youtube_comments, youtube_channel_videos |
125
+ | `get_social` | instagram_profile, instagram_post, tiktok_profile, pinterest_search, reddit_posts |
126
+ | `translate` | google_translate, bing_translate, yandex_translate |
127
+ | `extract` | text_extractor, article_extractor, link_extractor |
147
128
 
148
- **Engines**: perplexity, chatgpt, claude, gemini, copilot, grok, deepseek, deepai
129
+ ## Support
149
130
 
150
- ```
151
- ask_ai query="What are the benefits of Rust?" engine="claude"
152
- ```
153
-
154
- ### search_web
155
- Search the web or get trends data.
156
-
157
- **Engines**: google_search, bing_search, duckduckgo, yandex_search, yahoo_search, baidu_search, google_trends, rambler_search, you_search
158
-
159
- ```
160
- search_web query="best programming languages 2026"
161
- search_web query="AI" engine="google_trends"
162
- ```
163
-
164
- ### get_social
165
- Get data from social media platforms.
166
-
167
- **Engines**: instagram_profile, instagram_post, instagram_tag, instagram_geo, tiktok_profile, pinterest_search, reddit_posts, reddit_comments
168
-
169
- ```
170
- get_social query="@openai" engine="instagram_profile"
171
- get_social query="machine learning" engine="reddit_posts"
172
- ```
173
-
174
- ### get_video
175
- Search and get YouTube content.
176
-
177
- **Engines**: youtube_search, youtube_video, youtube_comments, youtube_channel_videos, youtube_channel_about
178
-
179
- ```
180
- get_video query="Python crash course"
181
- get_video query="https://youtube.com/watch?v=..." engine="youtube_comments"
182
- ```
183
-
184
- ### translate
185
- Translate text between languages.
186
-
187
- **Engines**: google_translate, bing_translate, yandex_translate
188
-
189
- ```
190
- translate query="Hello, how are you?"
191
- translate query="Bonjour" engine="yandex_translate"
192
- ```
193
-
194
- ### extract
195
- Extract content from web pages.
196
-
197
- **Engines**: text_extractor, article_extractor, link_extractor
198
-
199
- ```
200
- extract query="https://example.com/article" engine="article_extractor"
201
- extract query="https://example.com" engine="link_extractor"
202
- ```
203
-
204
- ### ayga_check_limits (New in v3.2.0)
205
- Check your API key rate limits and remaining quota.
206
-
207
- ```
208
- ayga_check_limits _placeholder=true
209
- ```
210
-
211
- Returns:
212
- ```json
213
- {
214
- "key_id": "abc123...",
215
- "minute": { "used": 5, "limit": 60, "remaining": 55 },
216
- "day": { "used": 100, "limit": 1000, "remaining": 900 }
217
- }
218
- ```
219
-
220
- ### list_parsers
221
- List all available parsers and their categories.
222
-
223
- ```
224
- list_parsers _placeholder=true
225
- ```
226
-
227
- ## Migration from v2.x
228
-
229
- **v2.x (40+ tools)**:
230
- ```
231
- search_perplexity query="What is MCP?"
232
- search_google_search query="latest news"
233
- search_youtube_video query="..."
234
- ```
235
-
236
- **v3.x (6 consolidated tools)**:
237
- ```
238
- ask_ai query="What is MCP?" # uses default: perplexity
239
- ask_ai query="What is MCP?" engine="perplexity" # explicit
240
- search_web query="latest news" # uses default: google_search
241
- get_video query="..." engine="youtube_video"
242
- ```
243
-
244
- ## Getting API Key
245
-
246
- ### New Users (Recommended)
247
-
248
- Get an `ayga_live_` key from the Telegram bot:
249
-
250
- 1. Open Telegram
251
- 2. Find [@aygamcp_bot](https://t.me/aygamcp_bot)
252
- 3. Send `/newkey` command
253
- 4. Copy the key (shown only once!)
254
-
255
- ### Legacy Users
256
-
257
- See [Migration Guide](docs/MIGRATION.md) for upgrading from legacy keys.
131
+ - Telegram: [@aygamcp_bot](https://t.me/aygamcp_bot)
132
+ - Email: support@ayga.tech
133
+ - GitHub: https://github.com/ozand/ayga-mcp-nodejs/issues
258
134
 
259
135
  ## License
260
136
 
261
137
  MIT
262
-
263
- ## Links
264
-
265
- - **API Backend**: https://redis.ayga.tech
266
- - **Python Version**: https://pypi.org/project/ayga-mcp-client/
267
- - **GitHub**: https://github.com/ozand/ayga-mcp-nodejs
268
- - **Issues**: https://github.com/ozand/ayga-mcp-nodejs/issues
package/package.json CHANGED
@@ -1,58 +1,58 @@
1
1
  {
2
2
  "name": "@ayga/mcp-client",
3
- "version": "3.2.0",
3
+ "version": "3.2.1",
4
4
  "description": "MCP client with 6 consolidated AI tools - stateless X-API-Key auth, no JWT exchange needed",
5
- "keywords": [
6
- "mcp",
7
- "model-context-protocol",
8
- "redis",
9
- "ai-parsers",
10
- "perplexity",
11
- "chatgpt",
12
- "claude",
13
- "instagram",
14
- "tiktok",
15
- "youtube",
16
- "google-trends",
17
- "pinterest",
18
- "translation"
19
- ],
20
- "author": "Ayga <https://ayga.tech>",
21
- "license": "MIT",
22
- "homepage": "https://github.com/ozand/ayga-mcp-nodejs#readme",
23
- "repository": {
24
- "type": "git",
25
- "url": "git+https://github.com/ozand/ayga-mcp-nodejs.git"
26
- },
27
- "bugs": {
28
- "url": "https://github.com/ozand/ayga-mcp-nodejs/issues"
29
- },
30
- "main": "dist/index.js",
31
- "type": "module",
32
- "bin": {
33
- "ayga-mcp-client": "dist/index.js"
34
- },
35
- "files": [
36
- "dist",
37
- "README.md",
38
- "LICENSE"
39
- ],
40
- "scripts": {
41
- "build": "tsc",
42
- "dev": "tsx src/index.ts",
43
- "test": "tsx src/test.ts",
44
- "prepublishOnly": "npm run build",
45
- "clean": "rm -rf dist"
46
- },
47
- "dependencies": {
48
- "@modelcontextprotocol/sdk": "^1.0.0"
49
- },
50
- "devDependencies": {
51
- "@types/node": "^20.0.0",
52
- "tsx": "^4.0.0",
53
- "typescript": "^5.3.0"
54
- },
55
- "engines": {
56
- "node": ">=18.0.0"
57
- }
58
- }
5
+ "keywords": [
6
+ "mcp",
7
+ "model-context-protocol",
8
+ "redis",
9
+ "ai-parsers",
10
+ "perplexity",
11
+ "chatgpt",
12
+ "claude",
13
+ "instagram",
14
+ "tiktok",
15
+ "youtube",
16
+ "google-trends",
17
+ "pinterest",
18
+ "translation"
19
+ ],
20
+ "author": "Ayga <https://ayga.tech>",
21
+ "license": "MIT",
22
+ "homepage": "https://github.com/ozand/ayga-mcp-nodejs#readme",
23
+ "repository": {
24
+ "type": "git",
25
+ "url": "git+https://github.com/ozand/ayga-mcp-nodejs.git"
26
+ },
27
+ "bugs": {
28
+ "url": "https://github.com/ozand/ayga-mcp-nodejs/issues"
29
+ },
30
+ "main": "dist/index.js",
31
+ "type": "module",
32
+ "bin": {
33
+ "ayga-mcp-client": "dist/index.js"
34
+ },
35
+ "files": [
36
+ "dist",
37
+ "README.md",
38
+ "LICENSE"
39
+ ],
40
+ "scripts": {
41
+ "build": "tsc",
42
+ "dev": "tsx src/index.ts",
43
+ "test": "tsx src/test.ts",
44
+ "prepublishOnly": "npm run build",
45
+ "clean": "rm -rf dist"
46
+ },
47
+ "dependencies": {
48
+ "@modelcontextprotocol/sdk": "^1.0.0"
49
+ },
50
+ "devDependencies": {
51
+ "@types/node": "^20.0.0",
52
+ "tsx": "^4.0.0",
53
+ "typescript": "^5.3.0"
54
+ },
55
+ "engines": {
56
+ "node": ">=18.0.0"
57
+ }
58
+ }