|
| 1 | +## Description |
| 2 | + |
| 3 | +Fixes #5438 |
| 4 | + |
| 5 | +This PR adds the Google Researcher MCP Server to the Roo Code marketplace as requested by @zoharbabin. The implementation includes a comprehensive configuration with multiple installation methods and proper API parameter setup. |
| 6 | + |
| 7 | +## Changes Made |
| 8 | + |
| 9 | +- **Added Google Researcher MCP Server configuration** to marketplace data (`src/services/marketplace/data/mcps.yaml`) |
| 10 | +- **Implemented local fallback functionality** in `RemoteConfigLoader` to support local marketplace data when remote API is unavailable |
| 11 | +- **Created comprehensive parameter definitions** for Google APIs: |
| 12 | + - Google Search API Key (required for search functionality) |
| 13 | + - Custom Search Engine ID (required for search configuration) |
| 14 | + - Gemini API Key (optional for enhanced AI capabilities) |
| 15 | +- **Added multiple installation methods**: |
| 16 | + - STDIO installation via npm package |
| 17 | + - Local installation with custom configuration |
| 18 | + - HTTP+SSE installation for server-based deployment |
| 19 | +- **Created integration tests** to verify end-to-end functionality |
| 20 | + |
| 21 | +## Technical Implementation |
| 22 | + |
| 23 | +### Local Fallback Architecture |
| 24 | + |
| 25 | +- Remote API remains the primary data source (maintains existing functionality) |
| 26 | +- Local YAML files serve as fallback when remote API is unavailable |
| 27 | +- Hybrid approach ensures development flexibility and production reliability |
| 28 | + |
| 29 | +### Google Researcher MCP Server Configuration |
| 30 | + |
| 31 | +- **Package**: `google-researcher-mcp@latest` from npm |
| 32 | +- **Repository**: https://github.com/zoharbabin/google-research-mcp |
| 33 | +- **Author**: Zohar Babin |
| 34 | +- **Capabilities**: Google Search-enhanced research for AI agents |
| 35 | + |
| 36 | +## Testing |
| 37 | + |
| 38 | +- [x] All existing core functionality tests pass |
| 39 | +- [x] New integration tests pass (2/2): |
| 40 | + - Google Researcher MCP Server loading from local data |
| 41 | + - Parameter configuration and installation methods validation |
| 42 | +- [x] Manual testing completed: |
| 43 | + - Marketplace can load Google Researcher MCP Server |
| 44 | + - All installation methods properly configured |
| 45 | + - API parameters correctly defined |
| 46 | + |
| 47 | +## Verification of Acceptance Criteria |
| 48 | + |
| 49 | +- [x] **Google Researcher MCP Server available in marketplace** |
| 50 | +- [x] **Proper configuration with required Google API parameters** |
| 51 | +- [x] **Multiple installation methods supported (STDIO, Local, HTTP+SSE)** |
| 52 | +- [x] **Integration with existing marketplace system** |
| 53 | +- [x] **Maintains backward compatibility with remote API** |
| 54 | + |
| 55 | +## Files Changed |
| 56 | + |
| 57 | +- `src/services/marketplace/data/mcps.yaml` - New local marketplace data file |
| 58 | +- `src/services/marketplace/RemoteConfigLoader.ts` - Added `loadLocalMcps()` method and local fallback logic |
| 59 | +- `src/services/marketplace/__tests__/google-researcher-integration.spec.ts` - New integration tests |
| 60 | + |
| 61 | +## Checklist |
| 62 | + |
| 63 | +- [x] Code follows project style guidelines |
| 64 | +- [x] Self-review completed |
| 65 | +- [x] Comments added for complex logic |
| 66 | +- [x] No breaking changes introduced |
| 67 | +- [x] Integration tests verify functionality |
| 68 | +- [x] Local fallback mechanism preserves existing remote API behavior |
| 69 | + |
| 70 | +## Notes |
| 71 | + |
| 72 | +This implementation addresses the specific request in issue #5438 to add the Google Researcher MCP Server to the marketplace. The local fallback mechanism ensures the marketplace system is more robust and developer-friendly while maintaining full compatibility with the existing remote API architecture. |
0 commit comments