Changes auto-save. Port/profile changes restart the server when needed.
+
MCP Client Config
@@ -129,6 +152,12 @@ module.exports = Editor.Panel.define({
gap: 8px;
align-items: end;
}
+ .tool-config-grid {
+ display: grid;
+ grid-template-columns: repeat(2, minmax(180px, 1fr));
+ gap: 8px;
+ margin-top: 8px;
+ }
label {
display: flex;
flex-direction: column;
@@ -138,6 +167,7 @@ module.exports = Editor.Panel.define({
.checkbox-line {
flex-direction: row;
align-items: center;
+ min-height: 28px;
}
.checkbox-inline {
padding-top: 0;
@@ -184,6 +214,9 @@ module.exports = Editor.Panel.define({
width: 100%;
min-height: 100px;
}
+ .tool-config-grid ui-textarea {
+ min-height: 72px;
+ }
pre {
min-height: 120px;
max-height: 220px;
@@ -203,12 +236,24 @@ module.exports = Editor.Panel.define({
$: {
root: '.mcp-root',
statusPill: '#statusPill',
+ versionText: '#versionText',
statusText: '#statusText',
enabledInput: '#enabledInput',
portInput: '#portInput',
profileSelect: '#profileSelect',
+ sessionsInput: '#sessionsInput',
restartBtn: '#restartBtn',
copyUrlBtn: '#copyUrlBtn',
+ checkUpdatesBtn: '#checkUpdatesBtn',
+ updateStatus: '#updateStatus',
+ toolSummary: '#toolSummary',
+ useCoreBtn: '#useCoreBtn',
+ useFullBtn: '#useFullBtn',
+ useCustomBtn: '#useCustomBtn',
+ enabledCategoriesInput: '#enabledCategoriesInput',
+ disabledCategoriesInput: '#disabledCategoriesInput',
+ enabledToolsInput: '#enabledToolsInput',
+ disabledToolsInput: '#disabledToolsInput',
clientTargetSelect: '#clientTargetSelect',
configureClientBtn: '#configureClientBtn',
clientTargetStatus: '#clientTargetStatus',
@@ -230,6 +275,7 @@ module.exports = Editor.Panel.define({
const config = state.config || {};
const isRunning = Boolean(status.running);
+ this.$.versionText.textContent = `Version ${status.version || 'unknown'}`;
this.$.statusPill.textContent = isRunning ? 'Running' : 'Stopped';
this.$.statusPill.classList.toggle('running', isRunning);
this.$.statusPill.classList.toggle('stopped', !isRunning);
@@ -242,10 +288,47 @@ module.exports = Editor.Panel.define({
this.$.enabledInput.value = Boolean(isRunning || config.autostart);
this.$.portInput.value = Number(config.port || status.port || 8765);
this.$.profileSelect.value = config.toolProfile || status.toolProfile || 'core';
+ this.$.sessionsInput.value = Boolean(config.enableSessions || status.enableSessions);
+ this.$.enabledCategoriesInput.value = this.formatList(config.enabledToolCategories);
+ this.$.disabledCategoriesInput.value = this.formatList(config.disabledToolCategories);
+ this.$.enabledToolsInput.value = this.formatList(config.enabledTools);
+ this.$.disabledToolsInput.value = this.formatList(config.disabledTools);
+ this.renderUpdateStatus();
+ this.renderToolSummary();
this.$.clientConfigText.value = state.clientConfig ? state.clientConfig.codex : '';
this.renderClientTargets();
},
+ formatList(value) {
+ return Array.isArray(value) ? value.join('\n') : '';
+ },
+ parseList(value) {
+ return String(value || '')
+ .split(/[\n,]/)
+ .map((item) => item.trim())
+ .filter(Boolean);
+ },
+ renderUpdateStatus() {
+ const update = this.state && this.state.updateInfo;
+ if (!update) {
+ this.$.updateStatus.textContent = '';
+ return;
+ }
+ if (!update.ok) {
+ this.$.updateStatus.textContent = `Update check failed: ${update.error}`;
+ return;
+ }
+ this.$.updateStatus.textContent = update.updateAvailable
+ ? `Update available: ${update.latestVersion} (${update.releaseUrl})`
+ : `Up to date: ${update.currentVersion}`;
+ },
+ renderToolSummary() {
+ const catalog = (this.state && this.state.toolCatalog) || [];
+ const enabled = catalog.filter((tool) => tool.enabled);
+ const categories = Array.from(new Set(catalog.map((tool) => tool.category))).sort();
+ this.$.toolSummary.textContent =
+ `Enabled ${enabled.length}/${catalog.length} tools | Categories: ${categories.join(', ')}`;
+ },
renderClientTargets() {
const targets = (this.state && this.state.clientTargets) || [];
const preferred = this.state && this.state.config ? this.state.config.lastClientTargetId : '';
@@ -299,6 +382,11 @@ module.exports = Editor.Panel.define({
host: (this.state && this.state.config && this.state.config.host) || (this.state && this.state.status && this.state.status.host) || '127.0.0.1',
port: Number(this.$.portInput.value || 8765),
toolProfile: this.$.profileSelect.value || 'core',
+ enabledToolCategories: this.parseList(this.$.enabledCategoriesInput.value).map((item) => item.toLowerCase()),
+ disabledToolCategories: this.parseList(this.$.disabledCategoriesInput.value).map((item) => item.toLowerCase()),
+ enabledTools: this.parseList(this.$.enabledToolsInput.value),
+ disabledTools: this.parseList(this.$.disabledToolsInput.value),
+ enableSessions: Boolean(this.$.sessionsInput.value),
autostart: Boolean(this.$.enabledInput.value),
maxInteractionLogEntries: this.state && this.state.config ? this.state.config.maxInteractionLogEntries : 50,
lastClientTargetId: this.$.clientTargetSelect.value || 'claude_code',
@@ -331,9 +419,35 @@ module.exports = Editor.Panel.define({
.then(() => this.showOutput('Copied URL to clipboard.'))
.catch(() => this.showOutput(text));
});
+ this.$.checkUpdatesBtn.addEventListener('click', () => this.runAction(() => request('check-updates')));
this.$.enabledInput.addEventListener('change', () => this.handleEnableToggle());
this.$.portInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
this.$.profileSelect.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.sessionsInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.enabledCategoriesInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.disabledCategoriesInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.enabledToolsInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.disabledToolsInput.addEventListener('change', () => this.persistConfig({ showOutput: true }));
+ this.$.useCoreBtn.addEventListener('click', () => {
+ this.$.profileSelect.value = 'core';
+ this.$.enabledCategoriesInput.value = '';
+ this.$.disabledCategoriesInput.value = '';
+ this.$.enabledToolsInput.value = '';
+ this.$.disabledToolsInput.value = '';
+ this.persistConfig({ showOutput: true });
+ });
+ this.$.useFullBtn.addEventListener('click', () => {
+ this.$.profileSelect.value = 'full';
+ this.$.enabledCategoriesInput.value = '';
+ this.$.disabledCategoriesInput.value = '';
+ this.$.enabledToolsInput.value = '';
+ this.$.disabledToolsInput.value = '';
+ this.persistConfig({ showOutput: true });
+ });
+ this.$.useCustomBtn.addEventListener('click', () => {
+ this.$.profileSelect.value = 'custom';
+ this.persistConfig({ showOutput: true });
+ });
this.$.clientTargetSelect.addEventListener('confirm', () => this.renderClientTargetStatus());
this.$.clientTargetSelect.addEventListener('change', () => {
this.renderClientTargetStatus();
diff --git a/test/logs.test.js b/test/logs.test.js
new file mode 100644
index 0000000..4ca42ba
--- /dev/null
+++ b/test/logs.test.js
@@ -0,0 +1,23 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const test = require('node:test');
+const { getRecentProjectLogs, searchProjectLogs } = require('../lib/logs');
+
+test('project log helpers read and search common project log files', () => {
+ const projectPath = fs.mkdtempSync(path.join(os.tmpdir(), 'funplay-cocos-logs-'));
+ const logDir = path.join(projectPath, 'temp', 'logs');
+ fs.mkdirSync(logDir, { recursive: true });
+ fs.writeFileSync(path.join(logDir, 'editor.log'), 'first line\nError: broken scene\nlast line\n', 'utf8');
+
+ const recent = getRecentProjectLogs(projectPath, { limit: 5, lines: 2 });
+ assert.equal(recent.length, 1);
+ assert.match(recent[0].text, /broken scene/);
+
+ const matches = searchProjectLogs(projectPath, { query: 'broken', limit: 5 });
+ assert.equal(matches.count, 1);
+ assert.equal(matches.matches[0].path, 'temp/logs/editor.log');
+});
diff --git a/test/server.test.js b/test/server.test.js
index 85cb354..4d378d5 100644
--- a/test/server.test.js
+++ b/test/server.test.js
@@ -1,6 +1,7 @@
'use strict';
const assert = require('node:assert/strict');
+const http = require('node:http');
const test = require('node:test');
const {
MCP_PROTOCOL_VERSION,
@@ -8,9 +9,9 @@ const {
SUPPORTED_PROTOCOL_VERSIONS,
} = require('../lib/server');
-function createServer(toolRegistry = {}) {
+function createServer(toolRegistry = {}, config = {}) {
return new McpServer({
- config: { host: '127.0.0.1', port: 8765 },
+ config: { host: '127.0.0.1', port: 8765, ...config },
toolRegistry: {
listTools: () => [],
callTool: async () => 'ok',
@@ -26,11 +27,45 @@ function createServer(toolRegistry = {}) {
getPrompt: () => ({ messages: [] }),
},
interactionLog: { add() {} },
+ runtimeLog: { add() {} },
serverName: 'test-server',
serverVersion: '0.0.0-test',
});
}
+function httpJson(port, payload, headers = {}) {
+ const body = payload === undefined ? '' : JSON.stringify(payload);
+ return new Promise((resolve, reject) => {
+ const request = http.request(
+ {
+ host: '127.0.0.1',
+ port,
+ method: 'POST',
+ path: '/',
+ headers: {
+ Accept: 'application/json, text/event-stream',
+ 'Content-Type': 'application/json',
+ 'Content-Length': Buffer.byteLength(body),
+ ...headers,
+ },
+ },
+ (response) => {
+ const chunks = [];
+ response.on('data', (chunk) => chunks.push(chunk));
+ response.on('end', () => {
+ resolve({
+ statusCode: response.statusCode,
+ headers: response.headers,
+ body: Buffer.concat(chunks).toString('utf8'),
+ });
+ });
+ }
+ );
+ request.on('error', reject);
+ request.end(body);
+ });
+}
+
test('initialize negotiates the current MCP protocol version by default', async () => {
const server = createServer();
const response = await server.handleRpcRequest({
@@ -126,3 +161,81 @@ test('unsupported protocol version headers are rejected when present after initi
assert.equal(response.error.code, -32600);
assert.match(response.error.message, /Unsupported MCP protocol version/);
});
+
+test('streamable HTTP Accept headers must allow json and event-stream', () => {
+ const server = createServer();
+
+ assert.equal(server.validateAcceptHeader({ headers: { accept: 'application/json, text/event-stream' } }), null);
+ assert.equal(server.validateAcceptHeader({ headers: { accept: '*/*' } }), null);
+
+ const response = server.validateAcceptHeader({ headers: { accept: 'application/json' } });
+ assert.equal(response.error.code, -32600);
+ assert.match(response.error.message, /Accept header/);
+});
+
+test('JSON-RPC responses and notifications are classified for 202 handling', () => {
+ const server = createServer();
+
+ assert.equal(server.classifyJsonRpcMessage({ jsonrpc: '2.0', id: 1, result: {} }), 'response');
+ assert.equal(server.classifyJsonRpcMessage({ jsonrpc: '2.0', method: 'notifications/initialized' }), 'notification');
+ assert.equal(server.classifyJsonRpcMessage({ jsonrpc: '2.0', id: 1, method: 'tools/list' }), 'request');
+});
+
+test('session validation requires a known session when enabled', () => {
+ const server = createServer({}, { enableSessions: true });
+ server.sessions.add('abc123');
+
+ assert.equal(
+ server.validateSession(
+ { headers: { 'mcp-session-id': 'abc123' } },
+ { jsonrpc: '2.0', id: 1, method: 'tools/list' }
+ ),
+ null
+ );
+
+ const missing = server.validateSession(
+ { headers: {} },
+ { jsonrpc: '2.0', id: 1, method: 'tools/list' }
+ );
+ assert.equal(missing.statusCode, 400);
+
+ const unknown = server.validateSession(
+ { headers: { 'mcp-session-id': 'nope' } },
+ { jsonrpc: '2.0', id: 1, method: 'tools/list' }
+ );
+ assert.equal(unknown.statusCode, 404);
+});
+
+test('HTTP notifications return 202 Accepted with no body', async () => {
+ const server = createServer({}, { port: 0 });
+ await server.start();
+ try {
+ const response = await httpJson(server.getPort(), {
+ jsonrpc: '2.0',
+ method: 'notifications/initialized',
+ });
+
+ assert.equal(response.statusCode, 202);
+ assert.equal(response.body, '');
+ } finally {
+ await server.stop();
+ }
+});
+
+test('HTTP initialize can return an optional session id when sessions are enabled', async () => {
+ const server = createServer({}, { port: 0, enableSessions: true });
+ await server.start();
+ try {
+ const response = await httpJson(server.getPort(), {
+ jsonrpc: '2.0',
+ id: 1,
+ method: 'initialize',
+ params: { protocolVersion: MCP_PROTOCOL_VERSION },
+ });
+
+ assert.equal(response.statusCode, 200);
+ assert.match(response.headers['mcp-session-id'], /^[\x21-\x7e]+$/);
+ } finally {
+ await server.stop();
+ }
+});
diff --git a/test/tool-registry.test.js b/test/tool-registry.test.js
index 1da8931..e82fa6d 100644
--- a/test/tool-registry.test.js
+++ b/test/tool-registry.test.js
@@ -5,13 +5,15 @@ const path = require('node:path');
const test = require('node:test');
const { createToolRegistry } = require('../lib/tool-registry');
-function createRegistry(profile, projectPath = path.resolve('/tmp/funplay-cocos-test-project')) {
+function createRegistry(profile, projectPath = path.resolve('/tmp/funplay-cocos-test-project'), configExtras = {}) {
return createToolRegistry({
getRuntimeContext: () => ({
- config: { toolProfile: profile },
+ config: { toolProfile: profile, ...configExtras },
projectPath,
+ version: '0.0.0-test',
}),
interactionLog: { add() {} },
+ runtimeLog: { list: () => [], clear: () => 0 },
sceneBridge: { call: async () => ({ ok: true }) },
editorExecutor: async () => ({ ok: true }),
});
@@ -19,21 +21,43 @@ function createRegistry(profile, projectPath = path.resolve('/tmp/funplay-cocos-
test('core profile exposes the documented focused tool set', () => {
const tools = createRegistry('core').listTools();
- assert.equal(tools.length, 22);
+ assert.equal(tools.length, 28);
assert.equal(tools.some((tool) => tool.name === 'execute_javascript'), true);
assert.equal(tools.some((tool) => tool.name === 'get_editor_state'), true);
+ assert.equal(tools.some((tool) => tool.name === 'get_tool_catalog'), true);
+ assert.equal(tools.some((tool) => tool.name === 'validate_scene'), true);
assert.equal(tools.some((tool) => tool.name === 'set_selection'), true);
assert.equal(tools.some((tool) => tool.name === 'write_file'), false);
});
test('full profile exposes all built-in tools', () => {
const tools = createRegistry('full').listTools();
- assert.equal(tools.length, 70);
+ assert.equal(tools.length, 76);
assert.equal(tools.some((tool) => tool.name === 'write_file'), true);
assert.equal(tools.some((tool) => tool.name === 'get_editor_state'), true);
assert.equal(tools.some((tool) => tool.name === 'set_selection'), true);
});
+test('custom profile can expose a category and disable a specific tool', () => {
+ const tools = createRegistry('custom', path.resolve('/tmp/funplay-cocos-test-project'), {
+ enabledToolCategories: ['files'],
+ disabledTools: ['write_file'],
+ }).listTools();
+
+ assert.equal(tools.some((tool) => tool.name === 'read_file'), true);
+ assert.equal(tools.some((tool) => tool.name === 'write_file'), false);
+ assert.equal(tools.some((tool) => tool.name === 'execute_javascript'), true);
+});
+
+test('tool catalog reports disabled tools under the current exposure settings', () => {
+ const catalog = createRegistry('core', path.resolve('/tmp/funplay-cocos-test-project'), {
+ disabledTools: ['execute_javascript'],
+ }).listToolCatalog();
+ const executeTool = catalog.find((tool) => tool.name === 'execute_javascript');
+ assert.equal(executeTool.enabled, false);
+ assert.equal(executeTool.category, 'execution');
+});
+
test('file tools reject writes outside the project root', async () => {
const registry = createRegistry('full');
await assert.rejects(
diff --git a/test/update-checker.test.js b/test/update-checker.test.js
new file mode 100644
index 0000000..79ff87e
--- /dev/null
+++ b/test/update-checker.test.js
@@ -0,0 +1,15 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const test = require('node:test');
+const { compareVersions, normalizeVersion } = require('../lib/update-checker');
+
+test('normalizeVersion removes release tag prefixes and metadata', () => {
+ assert.equal(normalizeVersion('v1.2.3-beta+build'), '1.2.3');
+});
+
+test('compareVersions compares semantic version numbers', () => {
+ assert.equal(compareVersions('1.2.4', '1.2.3'), 1);
+ assert.equal(compareVersions('1.2.3', '1.2.4'), -1);
+ assert.equal(compareVersions('1.2.3', 'v1.2.3'), 0);
+});