@gotza02/mathinking 3.1.2 → 3.1.3

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 +38 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -58,12 +58,39 @@ npx -y @gotza02/mathinking
58
58
 
59
59
  ## ⚙️ Configuration
60
60
 
61
+ ### Environment Variables
62
+
61
63
  Set these environment variables to enable enhanced search capabilities:
62
64
 
63
- | Variable | Description |
64
- |----------|-------------|
65
- | `BRAVE_SEARCH_API_KEY` | For Brave Search |
66
- | `EXA_API_KEY` | For Exa.ai Search |
65
+ | Variable | Required | Description |
66
+ |----------|----------|-------------|
67
+ | `BRAVE_SEARCH_API_KEY` | Optional | For Brave Search (Recommended - Fast & Free tier) |
68
+ | `EXA_API_KEY` | Optional | For Exa.ai Search (AI-Native Search) |
69
+ | `GOOGLE_SEARCH_API_KEY` | Optional | Google Custom Search JSON API |
70
+ | `GOOGLE_SEARCH_CX` | Optional | Google Custom Search Engine ID |
71
+
72
+ **Note:** At least one search provider API key is required for `web_search` to function. The system will try providers in this priority order:
73
+ 1. Brave Search → 2. Exa.ai → 3. Google → 4. Return "Configuration Required" message
74
+
75
+ ### Quick Setup (~/.bashrc)
76
+
77
+ Add these lines to your `~/.bashrc`:
78
+
79
+ ```bash
80
+ # Brave Search (Recommended - Get free key at https://api.search.brave.com/app/keys)
81
+ export BRAVE_SEARCH_API_KEY="your_brave_key_here"
82
+
83
+ # Exa.ai Search (Get key at https://exa.ai)
84
+ export EXA_API_KEY="your_exa_key_here"
85
+
86
+ # Google Custom Search (Get key at https://console.cloud.google.com/apis/credentials)
87
+ export GOOGLE_SEARCH_API_KEY="your_google_key_here"
88
+ export GOOGLE_SEARCH_CX="your_search_engine_id"
89
+ ```
90
+
91
+ Then reload: `source ~/.bashrc`
92
+
93
+ ---
67
94
 
68
95
  ### 1. Gemini CLI
69
96
  Add to your `~/.gemini/settings.json`:
@@ -214,7 +241,13 @@ You can define tasks that only run if a certain condition is met:
214
241
 
215
242
  **Full changelog available in [CHANGELOG.md](CHANGELOG.md)**
216
243
 
217
- ### v3.1.2 (Latest) - 📝 Documentation
244
+ ### v3.1.3 (Latest) - 📝 Documentation
245
+ - **Added:** Comprehensive "Environment Variables" table with all search provider keys
246
+ - **Added:** "Quick Setup (~/.bashrc)" section with copy-paste ready examples
247
+ - **Clarified:** At least one API key is required for web_search to function
248
+ - **Improved:** Distinguished between global setup (~/.bashrc) and MCP-specific config
249
+
250
+ ### v3.1.2 - 📝 Documentation
218
251
  - **Added:** Comprehensive web_search configuration section with provider details
219
252
  - **Clarified:** web_search tool registration status and API key requirements
220
253
  - **Added:** Provider priority fallback chain documentation (Brave > Exa > Google)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gotza02/mathinking",
3
- "version": "3.1.2",
3
+ "version": "3.1.3",
4
4
  "description": "MCP Server with sequential thinking (The Brain) and orchestrator (The Body) capabilities",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",