synth-execute
Generate and execute SuperCollider SynthDef code to produce audio output with specified duration. Create custom synthesizers and play them directly from code blocks.
Instructions
SynthDefのコードを生成し、そのコードを実行して音を出します。 コードは{}でくくるようにしてください。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| synth | Yes | 再生するシンセの情報 | |
| duration | No | 再生時間（ミリ秒）。デフォルトは5000（5秒） |
Implementation Reference
- src/index.ts:99-140 (handler)Handler function that initializes SuperCollider server, defines and plays the synth using provided code and name, waits for the specified duration, cleans up the server, and returns execution details or error.
async ({ synth, duration = 5000 }) => { try { const scServer = await initServer(); const def = await scServer.synthDef(synth.name, synth.code); await scServer.synth(def); console.error(`シンセを${duration / 1000}秒間演奏中...`); await new Promise(resolve => setTimeout(resolve, duration)); await cleanupServer(); console.error('シンセの演奏完了'); return { content: [ { type: "text", text: `シンセ名: ${synth.name}`, }, { type: "text", text: `コード: ${synth.code}`, }, { type: "text", text: `再生時間: ${duration / 1000}秒`, } ], }; } catch (error) { console.error("SuperCollider実行エラー:", error); return { content: [ { type: "text", text: `エラーが発生しました: ${error instanceof Error ? error.message : JSON.stringify(error, Object.getOwnPropertyNames(error), 2)}`, } ], }; } } - src/index.ts:92-98 (schema)Input schema using Zod for synth name, code, and optional duration in milliseconds.
{ synth: z.object({ name: z.string().describe("シンセの名前"), code: z.string().describe("シンセのコード") }).describe("再生するシンセの情報"), duration: z.number().optional().describe("再生時間（ミリ秒）。デフォルトは5000（5秒）") }, - src/index.ts:88-141 (registration)Registration of the 'synth-execute' tool using server.tool() with name, description, schema, and handler.
server.tool( "synth-execute", `SynthDefのコードを生成し、そのコードを実行して音を出します。 コードは{}でくくるようにしてください。`, { synth: z.object({ name: z.string().describe("シンセの名前"), code: z.string().describe("シンセのコード") }).describe("再生するシンセの情報"), duration: z.number().optional().describe("再生時間（ミリ秒）。デフォルトは5000（5秒）") }, async ({ synth, duration = 5000 }) => { try { const scServer = await initServer(); const def = await scServer.synthDef(synth.name, synth.code); await scServer.synth(def); console.error(`シンセを${duration / 1000}秒間演奏中...`); await new Promise(resolve => setTimeout(resolve, duration)); await cleanupServer(); console.error('シンセの演奏完了'); return { content: [ { type: "text", text: `シンセ名: ${synth.name}`, }, { type: "text", text: `コード: ${synth.code}`, }, { type: "text", text: `再生時間: ${duration / 1000}秒`, } ], }; } catch (error) { console.error("SuperCollider実行エラー:", error); return { content: [ { type: "text", text: `エラーが発生しました: ${error instanceof Error ? error.message : JSON.stringify(error, Object.getOwnPropertyNames(error), 2)}`, } ], }; } } ); - src/index.ts:21-46 (helper)Helper function to initialize and boot the SuperCollider server, ensuring singleton instance.
async function initServer(): Promise<SCServer> { if (serverInitPromise) { return serverInitPromise; } serverInitPromise = (async () => { try { console.error("SuperColliderサーバーを起動中..."); const server = await (sc as any).server.boot({ debug: false, echo: false, stderr: './supercollider-error.log' }) as SCServer; console.error("SuperColliderサーバー起動完了"); scServerInstance = server; return server; } catch (err) { console.error("SuperColliderサーバー起動エラー:", err); serverInitPromise = null; throw err; } })(); return serverInitPromise!; } - src/index.ts:55-79 (helper)Helper function to quit the SuperCollider server, reset state, and kill processes if necessary.
async function cleanupServer() { if (scServerInstance) { try { await scServerInstance.quit(); scServerInstance = null; serverInitPromise = null; activeSynths = []; try { if (process.platform === 'win32') { require('child_process').execSync('taskkill /F /IM sclang.exe', { stdio: 'ignore' }); } else { require('child_process').execSync('pkill -f sclang', { stdio: 'ignore' }); } } catch (killErr) { console.error('sclangプロセス終了試行:', killErr); } console.error('SuperColliderサーバーを終了しました'); } catch (error) { console.error("サーバー終了エラー:", error); } } }