@vjlanguage/mcp-vj-docs
Version:
MCP server for documentation crawling, indexing, and retrieval
242 lines (241 loc) • 11.4 kB
JavaScript
;
var __assign = (this && this.__assign) || function () {
__assign = Object.assign || function(t) {
for (var s, i = 1, n = arguments.length; i < n; i++) {
s = arguments[i];
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
t[p] = s[p];
}
return t;
};
return __assign.apply(this, arguments);
};
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
return new (P || (P = Promise))(function (resolve, reject) {
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
step((generator = generator.apply(thisArg, _arguments || [])).next());
});
};
var __generator = (this && this.__generator) || function (thisArg, body) {
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
function verb(n) { return function (v) { return step([n, v]); }; }
function step(op) {
if (f) throw new TypeError("Generator is already executing.");
while (g && (g = 0, op[0] && (_ = 0)), _) try {
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
if (y = 0, t) op = [op[0] & 2, t.value];
switch (op[0]) {
case 0: case 1: t = op; break;
case 4: _.label++; return { value: op[1], done: false };
case 5: _.label++; y = op[1]; op = [0]; continue;
case 7: op = _.ops.pop(); _.trys.pop(); continue;
default:
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
if (t[2]) _.ops.pop();
_.trys.pop(); continue;
}
op = body.call(thisArg, _);
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
}
};
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
var commander_1 = require("commander");
var child_process_1 = require("child_process");
var path_1 = __importDefault(require("path"));
var fs_1 = __importDefault(require("fs"));
var os_1 = __importDefault(require("os"));
var child_process_2 = require("child_process");
var indexPath = path_1.default.resolve(__dirname, '../index.js');
function expandTildePath(filePath) {
if (!filePath || typeof filePath !== 'string') {
return filePath;
}
if (filePath.startsWith('~/') || filePath === '~') {
return path_1.default.join(os_1.default.homedir(), filePath.substring(1));
}
return filePath;
}
var DEFAULT_DB_PATH = '~/mcpdata/docs.json';
var DEFAULT_TFIDF_DIR = '~/mcpdata/tfidf';
var PID_FILE_PATH = expandTildePath('~/mcpdata/vjdoc-server.pid');
function ensurePidFileDirectory() {
var pidDir = path_1.default.dirname(PID_FILE_PATH);
if (!fs_1.default.existsSync(pidDir)) {
fs_1.default.mkdirSync(pidDir, { recursive: true });
}
}
function writePidFile(pid) {
ensurePidFileDirectory();
fs_1.default.writeFileSync(PID_FILE_PATH, pid.toString(), 'utf8');
console.log("Server process ID (".concat(pid, ") saved to ").concat(PID_FILE_PATH));
}
function readPidFile() {
try {
if (fs_1.default.existsSync(PID_FILE_PATH)) {
var pid = parseInt(fs_1.default.readFileSync(PID_FILE_PATH, 'utf8').trim(), 10);
return isNaN(pid) ? null : pid;
}
}
catch (error) {
console.error("Error reading PID file: ".concat(error));
}
return null;
}
function isProcessRunning(pid) {
return new Promise(function (resolve) {
if (process.platform === 'win32') {
(0, child_process_2.exec)("tasklist /FI \"PID eq ".concat(pid, "\""), function (error, stdout) {
resolve(stdout.includes("".concat(pid)));
});
}
else {
(0, child_process_2.exec)("ps -p ".concat(pid), function (error, stdout) {
resolve(stdout.includes("".concat(pid)));
});
}
});
}
var program = new commander_1.Command();
program
.name('vjdoc-cli')
.description('CLI for VJ Documentation MCP Server')
.version('0.1.2');
program
.command('stream-start')
.description('Start the server in HTTP Stream mode')
.option('-p, --port <number>', 'Port to run the HTTP Stream server on', '3000')
.option('-d, --db-path <path>', 'Path to the database file', DEFAULT_DB_PATH)
.option('--tfidf-dir <path>', 'Path to the TF-IDF files directory', DEFAULT_TFIDF_DIR)
.action(function (options) {
console.log('Starting VJ Documentation MCP Server in HTTP Stream mode');
var env = __assign(__assign({}, process.env), { ENABLE_STDIO_TRANSPORT: 'false', ENABLE_LEGACY_SSE: 'false', ENABLE_STREAMABLE_HTTP: 'true', STREAMABLE_HTTP_PORT: options.port, VJDOC_DB_PATH: DEFAULT_DB_PATH, VJDOC_TFIDF_FILES_DIR: DEFAULT_TFIDF_DIR });
if (options.dbPath) {
env.VJDOC_DB_PATH = expandTildePath(options.dbPath);
}
if (options.tfidfDir) {
env.VJDOC_TFIDF_FILES_DIR = expandTildePath(options.tfidfDir);
}
var server = (0, child_process_1.spawn)('node', [indexPath], {
env: env,
stdio: 'inherit'
});
server.on('error', function (err) {
console.error('Failed to start HTTP Stream server:', err);
process.exit(1);
});
process.on('SIGINT', function () {
console.log('Shutting down HTTP Stream server...');
server.kill();
process.exit(0);
});
});
program
.command('stream-serve')
.description('Start the server in HTTP Stream mode as a background service')
.option('-p, --port <number>', 'Port to run the HTTP Stream server on', '3000')
.option('-d, --db-path <path>', 'Path to the database file', DEFAULT_DB_PATH)
.option('--tfidf-dir <path>', 'Path to the TF-IDF files directory', DEFAULT_TFIDF_DIR)
.action(function (options) { return __awaiter(void 0, void 0, void 0, function () {
var existingPid, isRunning, env, server;
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
existingPid = readPidFile();
if (!existingPid) return [3, 2];
return [4, isProcessRunning(existingPid)];
case 1:
isRunning = _a.sent();
if (isRunning) {
console.log("Server is already running with PID ".concat(existingPid));
console.log("To stop the server, use: vjdoc-cli stream-stop");
return [2];
}
else {
console.log("Found stale PID file for non-existent process ".concat(existingPid, ", will start a new server"));
}
_a.label = 2;
case 2:
console.log('Starting VJ Documentation MCP Server in background mode...');
env = __assign(__assign({}, process.env), { ENABLE_STDIO_TRANSPORT: 'false', ENABLE_LEGACY_SSE: 'false', ENABLE_STREAMABLE_HTTP: 'true', STREAMABLE_HTTP_PORT: options.port, VJDOC_DB_PATH: expandTildePath(options.dbPath || DEFAULT_DB_PATH), VJDOC_TFIDF_FILES_DIR: expandTildePath(options.tfidfDir || DEFAULT_TFIDF_DIR) });
server = (0, child_process_1.spawn)('node', [indexPath], {
env: env,
stdio: 'ignore',
detached: true
});
server.unref();
if (server.pid === undefined) {
console.error('Failed to get server process ID');
return [2];
}
writePidFile(server.pid);
console.log("Server started in background mode with PID ".concat(server.pid));
console.log("To stop the server, use: vjdoc-cli stream-stop");
return [2];
}
});
}); });
program
.command('stream-stop')
.description('Stop the background server process')
.action(function () { return __awaiter(void 0, void 0, void 0, function () {
var pid, isRunning;
return __generator(this, function (_a) {
switch (_a.label) {
case 0:
pid = readPidFile();
if (!pid) {
console.log('No server PID file found. Server might not be running.');
return [2];
}
return [4, isProcessRunning(pid)];
case 1:
isRunning = _a.sent();
if (!isRunning) {
console.log("No server process found with PID ".concat(pid, ". Cleaning up PID file..."));
try {
fs_1.default.unlinkSync(PID_FILE_PATH);
console.log('PID file removed.');
}
catch (error) {
console.error("Error removing PID file: ".concat(error));
}
return [2];
}
console.log("Stopping server process with PID ".concat(pid, "..."));
try {
if (process.platform === 'win32') {
(0, child_process_2.exec)("taskkill /PID ".concat(pid, " /F"), function (error) {
if (error) {
console.error("Error stopping server: ".concat(error));
return;
}
console.log('Server stopped successfully.');
fs_1.default.unlinkSync(PID_FILE_PATH);
});
}
else {
process.kill(pid);
console.log('Server stopped successfully.');
fs_1.default.unlinkSync(PID_FILE_PATH);
}
}
catch (error) {
console.error("Error stopping server: ".concat(error));
}
return [2];
}
});
}); });
program.parse(process.argv);