#!/usr/bin/env node
import { createInterface } from 'readline';
import { writeFileSync, existsSync, mkdirSync } from 'fs';
import { resolve, dirname, join } from 'path';
import { fileURLToPath } from 'url';
import { homedir } from 'os';
const __dirname = dirname(fileURLToPath(import.meta.url));
const globalConfigDir = join(homedir(), '.wordpress-mcp');
const globalEnvPath = join(globalConfigDir, '.env');
const rl = createInterface({
input: process.stdin,
output: process.stdout,
});
const question = (query) => new Promise((resolve) => rl.question(query, resolve));
console.log('š WordPress MCP Server Setup\n');
console.log('This wizard will help you configure your WordPress MCP server.\n');
async function setup() {
try {
let skipEnvCreation = false;
let wpUrl, wpUsername, wpAppPassword;
let envPath = globalEnvPath;
// Ask where to save the .env file
console.log('š Configuration Location\n');
console.log('Where would you like to save your WordPress credentials?\n');
console.log('1. Global location (~/.wordpress-mcp/.env) - Recommended');
console.log('2. Local directory (./.env) - For development\n');
const locationChoice = await question('Choose location (1-2) [1]: ') || '1';
if (locationChoice === '2') {
envPath = '.env';
} else {
// Create global config directory if it doesn't exist
if (!existsSync(globalConfigDir)) {
mkdirSync(globalConfigDir, { recursive: true });
}
}
// Check if .env already exists at chosen location
if (existsSync(envPath)) {
const overwrite = await question(`\n${envPath} already exists. Overwrite? (y/N): `);
if (overwrite.toLowerCase() !== 'y') {
console.log(`\nā Keeping existing ${envPath} file.`);
skipEnvCreation = true;
// Try to read existing .env for config examples
try {
const { readFileSync } = await import('fs');
const envContent = readFileSync(envPath, 'utf-8');
const envVars = {};
envContent.split('\n').forEach(line => {
const match = line.match(/^([^#=]+)=(.*)$/);
if (match) {
envVars[match[1].trim()] = match[2].trim();
}
});
// Check if required values exist
const hasUrl = envVars.WORDPRESS_URL && envVars.WORDPRESS_URL !== '';
const hasUsername = envVars.WORDPRESS_USERNAME && envVars.WORDPRESS_USERNAME !== '';
const hasPassword = envVars.WORDPRESS_APP_PASSWORD && envVars.WORDPRESS_APP_PASSWORD !== '';
if (!hasUrl || !hasUsername || !hasPassword) {
console.log('\nā ļø Warning: Your .env file appears to be missing required values.');
console.log(' Consider running setup again and choosing to overwrite.\n');
wpUrl = 'https://your-site.com';
wpUsername = 'your-username';
wpAppPassword = 'your-app-password';
console.log('š Showing configuration examples with placeholder values.\n');
} else {
wpUrl = envVars.WORDPRESS_URL;
wpUsername = envVars.WORDPRESS_USERNAME;
wpAppPassword = envVars.WORDPRESS_APP_PASSWORD;
console.log('\nš Using values from existing .env for configuration examples.\n');
}
} catch (e) {
// If we can't read .env, use placeholder values
wpUrl = 'https://your-site.com';
wpUsername = 'your-username';
wpAppPassword = 'your-app-password';
console.log('\nš Showing configuration examples with placeholder values.\n');
}
}
}
// Only collect details if we're creating/updating .env
if (!skipEnvCreation) {
// Collect WordPress details
console.log('\nš WordPress Configuration\n');
wpUrl = await question('WordPress Site URL (e.g., https://example.com): ');
if (!wpUrl.startsWith('http')) {
console.error('\nā Error: URL must start with http:// or https://');
process.exit(1);
}
wpUsername = await question('WordPress Username: ');
console.log('\nš” Tip: Use Application Passwords for better security.');
console.log(' Generate one at: Users > Your Profile > Application Passwords\n');
wpAppPassword = await question('WordPress Application Password: ');
}
// Ask about default personality
console.log('\nš Default Personality Selection\n');
console.log('1. Contributor - Limited tools for content creation');
console.log('2. Author - Full authoring capabilities (recommended)');
console.log('3. Administrator - Complete site management\n');
const personalityChoice = await question('Choose default personality (1-3) [2]: ') || '2';
const personalities = {
'1': 'contributor',
'2': 'author',
'3': 'administrator'
};
const defaultPersonality = personalities[personalityChoice] || 'author';
// Create .env file only if not skipping
if (!skipEnvCreation) {
const envContent = `# WordPress site URL (without trailing slash)
WORDPRESS_URL=${wpUrl.replace(/\/$/, '')}
# WordPress authentication
WORDPRESS_USERNAME=${wpUsername}
WORDPRESS_APP_PASSWORD=${wpAppPassword}
# Optional: Default personality if not specified at launch
MCP_PERSONALITY=${defaultPersonality}
`;
writeFileSync(envPath, envContent);
console.log(`\nā
Created ${envPath} file successfully!`);
}
// Get absolute path for configurations
const serverPath = resolve(__dirname, 'src/server.js');
// Ask about showing credentials
console.log('\nš Security Option\n');
const showCredentials = await question('Show your credentials in the configuration examples? (y/N): ');
const shouldShowCredentials = showCredentials.toLowerCase() === 'y';
// Prepare display values
const displayUrl = shouldShowCredentials ? wpUrl.replace(/\/$/, '') : 'https://your-site.com';
const displayUsername = shouldShowCredentials ? wpUsername : 'your-username';
const displayPassword = shouldShowCredentials ? wpAppPassword : 'your-app-password';
if (!shouldShowCredentials) {
console.log('\nā Credentials will be masked in the examples below.');
}
// Show Claude Desktop configuration
console.log('\nš± Claude Desktop Configuration\n');
console.log('Add this to your Claude Desktop config file:');
console.log('\nmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json');
console.log('Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n');
const claudeDesktopConfig = {
mcpServers: {
"wordpress-author": {
command: "node",
args: [
serverPath,
`--personality=${defaultPersonality}`
]
}
}
};
console.log('```json');
console.log(JSON.stringify(claudeDesktopConfig, null, 2));
console.log('```');
console.log('\nNote: The server will read credentials from:');
console.log(` ${resolve(envPath)}`);
// Show Claude Code configuration
console.log('\nš» Claude Code Configuration\n');
console.log('Option 1: Use the CLI command (recommended):\n');
console.log('```bash');
console.log(`claude mcp add wordpress-author \\`);
console.log(` node ${serverPath} -- \\`);
console.log(` --personality=${defaultPersonality}`);
console.log('```');
console.log('\nOption 2: Manually add to your project\'s .claude/settings.json:\n');
const claudeCodeConfig = {
mcpServers: {
"wordpress-author": {
command: "node",
args: [
serverPath,
`--personality=${defaultPersonality}`
]
}
}
};
console.log('```json');
console.log(JSON.stringify(claudeCodeConfig, null, 2));
console.log('```');
console.log('\nNote: The server will read credentials from the .env file in:');
console.log(` ${__dirname}`);
// Final instructions
console.log('\nš Setup Complete!\n');
// Show actual credentials if user opted to see them
if (shouldShowCredentials) {
console.log('š Your WordPress credentials for reference:\n');
console.log(` URL: ${wpUrl.replace(/\/$/, '')}`);
console.log(` Username: ${wpUsername}`);
console.log(` Password: ${wpAppPassword}`);
console.log(` Default Personality: ${defaultPersonality}\n`);
console.log('ā ļø Keep these credentials secure!\n');
}
console.log('Next steps:');
console.log('1. Copy the configuration above to your Claude Desktop or Claude Code settings');
console.log('2. Restart Claude to load the MCP server');
console.log('3. Start using WordPress tools in your conversations!\n');
console.log('Example prompts to try:');
console.log('- "Create a draft blog post about web development"');
console.log('- "Show me all my draft posts"');
console.log('- "Publish the draft with ID 123"');
if (defaultPersonality !== 'administrator') {
console.log('\nš” Tip: You can change the personality at any time by modifying');
console.log(' the --personality parameter in your configuration.');
}
} catch (error) {
console.error('\nā Setup error:', error.message);
process.exit(1);
} finally {
rl.close();
}
}
// Handle Ctrl+C gracefully
process.on('SIGINT', () => {
console.log('\n\nSetup cancelled.');
process.exit(0);
});
setup();
