Template
91b78f8da1
Template repository for creating MokoStandards-compliant MCP servers.
Includes 4-file src/ structure (index, client, config, types), setup
wizard, example tools, 12 CI/CD workflows, full docs, and {{placeholder}}
tokens for search-and-replace customization.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
124 lines
4.1 KiB
JavaScript
124 lines
4.1 KiB
JavaScript
#!/usr/bin/env node
|
|
/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
|
|
*
|
|
* This file is part of a Moko Consulting project.
|
|
*
|
|
* SPDX-License-Identifier: GPL-3.0-or-later
|
|
*
|
|
* FILE INFORMATION
|
|
* DEFGROUP: {{PROJECT_NAME}}.Scripts
|
|
* INGROUP: {{PROJECT_NAME}}
|
|
* REPO: https://git.mokoconsulting.tech/MokoConsulting/{{PROJECT_NAME}}
|
|
* PATH: /scripts/setup.mjs
|
|
* VERSION: 01.00.00
|
|
* BRIEF: Interactive setup — prompts for API connection details and writes config
|
|
*/
|
|
|
|
import { createInterface } from 'node:readline/promises';
|
|
import { readFile, writeFile } from 'node:fs/promises';
|
|
import { resolve } from 'node:path';
|
|
import { homedir } from 'node:os';
|
|
|
|
// ── Customize these ─────────────────────────────────────────────────────
|
|
const PROJECT_NAME = '{{PROJECT_NAME}}';
|
|
const CONFIG_PATH = resolve(homedir(), `.${PROJECT_NAME}.json`);
|
|
const API_LABEL = '{{DISPLAY_NAME}}'; // e.g. "Dolibarr", "Joomla"
|
|
const AUTH_FIELD = 'apiKey'; // field name in config
|
|
const AUTH_PROMPT = 'API key'; // what to ask the user for
|
|
// ────────────────────────────────────────────────────────────────────────
|
|
|
|
const rl = createInterface({ input: process.stdin, output: process.stdout });
|
|
|
|
async function prompt(question, defaultValue) {
|
|
const suffix = defaultValue ? ` [${defaultValue}]` : '';
|
|
const answer = await rl.question(`${question}${suffix}: `);
|
|
return answer.trim() || defaultValue || '';
|
|
}
|
|
|
|
async function promptRequired(question) {
|
|
let answer = '';
|
|
while (!answer) {
|
|
answer = (await rl.question(`${question}: `)).trim();
|
|
if (!answer) {
|
|
console.log(' This field is required.');
|
|
}
|
|
}
|
|
return answer;
|
|
}
|
|
|
|
async function main() {
|
|
console.log('');
|
|
console.log(`=== ${PROJECT_NAME} Setup ===`);
|
|
console.log('');
|
|
console.log('This will create your configuration file at:');
|
|
console.log(` ${CONFIG_PATH}`);
|
|
console.log('');
|
|
|
|
let existing = null;
|
|
try {
|
|
const raw = await readFile(CONFIG_PATH, 'utf-8');
|
|
existing = JSON.parse(raw);
|
|
console.log('Existing config found. You can add a new connection or overwrite.');
|
|
console.log(` Current connections: ${Object.keys(existing.connections).join(', ')}`);
|
|
console.log('');
|
|
} catch {
|
|
// No existing config
|
|
}
|
|
|
|
const connectionName = await prompt('Connection name', 'production');
|
|
const baseUrl = await promptRequired(`${API_LABEL} URL (e.g. https://api.example.com)`);
|
|
const authValue = await promptRequired(`${API_LABEL} ${AUTH_PROMPT}`);
|
|
|
|
const cleanUrl = baseUrl.replace(/\/+$/, '');
|
|
|
|
const insecureAnswer = await prompt('Skip TLS verification for self-signed certs? (y/N)', 'N');
|
|
const insecure = insecureAnswer.toLowerCase() === 'y';
|
|
|
|
const connection = { baseUrl: cleanUrl, [AUTH_FIELD]: authValue };
|
|
if (insecure) {
|
|
connection.insecure = true;
|
|
}
|
|
|
|
let config;
|
|
if (existing) {
|
|
config = existing;
|
|
config.connections[connectionName] = connection;
|
|
const setDefault = await prompt(`Set "${connectionName}" as default connection? (y/N)`, 'N');
|
|
if (setDefault.toLowerCase() === 'y') {
|
|
config.defaultConnection = connectionName;
|
|
}
|
|
} else {
|
|
config = {
|
|
defaultConnection: connectionName,
|
|
connections: {
|
|
[connectionName]: connection,
|
|
},
|
|
};
|
|
}
|
|
|
|
await writeFile(CONFIG_PATH, JSON.stringify(config, null, '\t') + '\n', 'utf-8');
|
|
|
|
console.log('');
|
|
console.log(`Config written to ${CONFIG_PATH}`);
|
|
console.log(` Connection "${connectionName}" configured for ${cleanUrl}`);
|
|
console.log('');
|
|
|
|
const addAnother = await prompt('Add another connection? (y/N)', 'N');
|
|
if (addAnother.toLowerCase() === 'y') {
|
|
rl.close();
|
|
const { execFileSync } = await import('node:child_process');
|
|
execFileSync('node', [new URL(import.meta.url).pathname], { stdio: 'inherit' });
|
|
return;
|
|
}
|
|
|
|
console.log('Setup complete. You can now use the MCP server.');
|
|
console.log('');
|
|
rl.close();
|
|
}
|
|
|
|
main().catch((err) => {
|
|
console.error(`Setup failed: ${err.message}`);
|
|
rl.close();
|
|
process.exit(1);
|
|
});
|