setup.jsā¢7.47 kB
#!/usr/bin/env node
import fs from 'fs';
import path from 'path';
import readline from 'readline';
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout
});
function askQuestion(question) {
return new Promise((resolve) => {
rl.question(question, (answer) => {
resolve(answer);
});
});
}
function getClaudeConfigPath() {
const homeDir = process.env.USERPROFILE || process.env.HOME || '';
return path.join(homeDir, '.claude.json');
}
function getGlobalConfigPath() {
const homeDir = process.env.USERPROFILE || process.env.HOME || '';
return path.join(homeDir, '.google-search-mcp.json');
}
async function setupGlobalConfig(apiKeys, searchEngineIds) {
const configPath = getGlobalConfigPath();
const keys = [];
for (let i = 0; i < apiKeys.length; i++) {
keys.push({
id: `key_${i + 1}`,
apiKey: apiKeys[i].trim(),
searchEngineId: searchEngineIds[i]?.trim() || searchEngineIds[0]?.trim() || '',
dailyUsage: 0,
dailyLimit: 100,
lastReset: new Date().toISOString().split('T')[0],
isActive: true
});
}
const config = {
keys: keys,
lastUpdated: new Date().toISOString(),
version: '1.0.0'
};
fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
console.log(`ā
Global configuration saved to: ${configPath}`);
return configPath;
}
async function setupClaudeCode() {
const claudeConfigPath = getClaudeConfigPath();
try {
let claudeConfig = {};
if (fs.existsSync(claudeConfigPath)) {
const data = fs.readFileSync(claudeConfigPath, 'utf8');
claudeConfig = JSON.parse(data);
}
if (!claudeConfig.mcpServers) {
claudeConfig.mcpServers = {};
}
// Add our server with platform-specific command
const isWindows = process.platform === 'win32';
console.log(`š„ļø Platform detected: ${isWindows ? 'Windows' : 'Unix/Linux/macOS'}`);
if (isWindows) {
claudeConfig.mcpServers['google-search'] = {
"type": "stdio",
"command": "cmd",
"args": ["/c", "npx", "-y", "@kyaniiii/google-search-mcp"],
"env": {}
};
} else {
claudeConfig.mcpServers['google-search'] = {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kyaniiii/google-search-mcp"],
"env": {}
};
}
// Backup original
if (fs.existsSync(claudeConfigPath)) {
fs.writeFileSync(`${claudeConfigPath}.backup-${Date.now()}`, fs.readFileSync(claudeConfigPath));
}
// Write new config
fs.writeFileSync(claudeConfigPath, JSON.stringify(claudeConfig, null, 2));
console.log(`ā
Claude Code configured automatically`);
return true;
} catch (error) {
console.error(`ā Failed to configure Claude Code: ${error.message}`);
console.log('š” You can configure manually with:');
console.log(' claude mcp add google-search npx -y @kyaniiii/google-search-mcp');
return false;
}
}
async function validateApiKey(apiKey) {
if (!apiKey || apiKey.length < 30) {
return false;
}
if (!apiKey.startsWith('AIza') && !apiKey.startsWith('Aiza')) {
return false;
}
return true;
}
async function main() {
console.log('š Google Search MCP - Ultimate Setup');
console.log('=====================================\n');
// Check if already configured
const globalConfigPath = getGlobalConfigPath();
if (fs.existsSync(globalConfigPath)) {
console.log('ā ļø Global configuration already exists!');
const overwrite = await askQuestion('Do you want to reconfigure? (y/N): ');
if (overwrite.toLowerCase() !== 'y') {
console.log('Setup cancelled. Current configuration preserved.');
rl.close();
return;
}
}
console.log('š Let\'s get your Google API credentials:\n');
console.log('š Get your API keys here:');
console.log(' ā https://console.cloud.google.com/apis/credentials');
console.log(' ā Enable "Custom Search API"');
console.log(' ā Create "API Key"\n');
console.log('š Get your Search Engine ID here:');
console.log(' ā https://programmablesearchengine.google.com/');
console.log(' ā Create new search engine');
console.log(' ā Sites to search: * (for entire web)');
console.log(' ā Copy the "Search engine ID"\n');
// Get API keys
const apiKeysInput = await askQuestion('Enter your Google API key(s) (comma-separated for multiple): ');
const apiKeys = apiKeysInput.split(',').map(k => k.trim()).filter(k => k);
if (apiKeys.length === 0) {
console.log('ā At least one API key is required!');
rl.close();
return;
}
// Validate API keys
const invalidKeys = [];
for (const key of apiKeys) {
if (!(await validateApiKey(key))) {
invalidKeys.push(key.substring(0, 10) + '...');
}
}
if (invalidKeys.length > 0) {
console.log(`ā ļø Warning: These keys look invalid: ${invalidKeys.join(', ')}`);
const proceed = await askQuestion('Continue anyway? (y/N): ');
if (proceed.toLowerCase() !== 'y') {
console.log('Setup cancelled.');
rl.close();
return;
}
}
// Get Search Engine IDs
const engineIdsInput = await askQuestion('Enter your Custom Search Engine ID(s) (comma-separated): ');
const engineIds = engineIdsInput.split(',').map(e => e.trim()).filter(e => e);
if (engineIds.length === 0) {
console.log('ā At least one Search Engine ID is required!');
rl.close();
return;
}
if (apiKeys.length !== engineIds.length) {
console.log(`ā¹ļø Using first Search Engine ID (${engineIds[0]}) for all API keys`);
}
console.log('\nš§ Setting up configuration...');
try {
// Setup global config
await setupGlobalConfig(apiKeys, engineIds);
// Setup Claude Code
const claudeSuccess = await setupClaudeCode();
console.log('\nš Setup completed successfully!');
console.log('\nš Configuration summary:');
console.log(` ā¢ API Keys: ${apiKeys.length}`);
console.log(` ā¢ Search Engines: ${engineIds.length}`);
console.log(` ā¢ Daily Quota: ${apiKeys.length * 100} searches`);
console.log(` ā¢ Config File: ${globalConfigPath}`);
if (claudeSuccess) {
console.log(' ā¢ Claude Code: ā
Configured automatically');
console.log('\nš Ready to use! Try asking Claude to search for something.');
} else {
console.log(' ā¢ Claude Code: ā ļø Manual configuration needed');
console.log('\nš To complete setup, run:');
console.log(' claude mcp add google-search npx -y @kyaniiii/google-search-mcp');
}
console.log('\nš” Tips:');
console.log(' ā¢ Quotas reset daily at midnight UTC');
console.log(' ā¢ Server automatically rotates between API keys');
console.log(' ā¢ Configuration is stored globally and persistent');
} catch (error) {
console.error(`\nā Setup failed: ${error.message}`);
console.log('\nPlease try again or check the documentation:');
console.log('https://github.com/Fabien-desablens/google-search-mcp#readme');
}
rl.close();
}
// Handle Ctrl+C gracefully
process.on('SIGINT', () => {
console.log('\n\nā¹ļø Setup cancelled by user');
rl.close();
process.exit(0);
});
main().catch(error => {
console.error('š„ Unexpected error:', error);
rl.close();
process.exit(1);
});