Dart MCP Server

Instructions

Implementation Reference

• src/index.ts:433-495 (registration)

  Registration of the 'create_space' tool in the listTools handler, including its description and detailed input schema.
  { name: 'create_space', description: 'Create a new space', inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'Title of the space' }, description: { type: 'string', description: 'Description of the space' }, abrev: { type: 'string', description: 'Short abbreviation for the space' }, accessible_by_team: { type: 'boolean', description: 'Whether the space is accessible by the whole team', default: true }, accessible_by_user_duids: { type: 'array', items: { type: 'string' }, description: 'List of user DUIDs who can access the space' }, icon_kind: { type: 'string', enum: ['None', 'Icon', 'Emoji'], description: 'Kind of icon to use', default: 'None' }, icon_name_or_emoji: { type: 'string', description: 'Icon name or emoji character' }, color_hex: { type: 'string', description: 'Color in hex format (e.g. #FF0000)' }, sprint_mode: { type: 'string', enum: ['None', 'ANBA'], description: 'Sprint mode for the space', default: 'None' }, sprint_replicate_on_rollover: { type: 'boolean', description: 'Whether to replicate sprints on rollover', default: false }, sprint_name_fmt: { type: 'string', description: 'Sprint name format' } }, required: ['title'] } },
• src/index.ts:436-494 (schema)

  Input schema for the 'create_space' tool defining parameters like title, description, access controls, icon, color, and sprint settings.
  inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'Title of the space' }, description: { type: 'string', description: 'Description of the space' }, abrev: { type: 'string', description: 'Short abbreviation for the space' }, accessible_by_team: { type: 'boolean', description: 'Whether the space is accessible by the whole team', default: true }, accessible_by_user_duids: { type: 'array', items: { type: 'string' }, description: 'List of user DUIDs who can access the space' }, icon_kind: { type: 'string', enum: ['None', 'Icon', 'Emoji'], description: 'Kind of icon to use', default: 'None' }, icon_name_or_emoji: { type: 'string', description: 'Icon name or emoji character' }, color_hex: { type: 'string', description: 'Color in hex format (e.g. #FF0000)' }, sprint_mode: { type: 'string', enum: ['None', 'ANBA'], description: 'Sprint mode for the space', default: 'None' }, sprint_replicate_on_rollover: { type: 'boolean', description: 'Whether to replicate sprints on rollover', default: false }, sprint_name_fmt: { type: 'string', description: 'Sprint name format' } }, required: ['title'] }
• src/index.ts:1017-1104 (handler)

  Handler logic for 'create_space' tool. Dynamically generates Python code that initializes Dart client, creates SpaceCreate object with provided parameters, builds CREATE operation, and executes transaction via client.transact. Returns the created space DUID and details.
  case 'create_space': { console.error('[Debug] Handling create_space request'); const pythonCode = ` import sys import json from dart import Dart, Operation, OperationKind, OperationModelKind, SpaceCreate, TransactionKind from dart.dart import _Session, UserBundle, _make_duid from dart.generated.models.icon_kind import IconKind print("[Debug] Starting Python execution", file=sys.stderr) # Parse arguments from JSON args_json = '''${JSON.stringify(args)}''' args = json.loads(args_json) print(f"[Debug] Parsed args: {args}", file=sys.stderr) # Initialize session and client session = _Session() print("[Debug] Session created", file=sys.stderr) bundle = UserBundle(session) print("[Debug] UserBundle created", file=sys.stderr) client = Dart() print("[Debug] Dart client created", file=sys.stderr) # Get the user's DUID user_duid = bundle.user["duid"] print(f"[Debug] User DUID: {user_duid}", file=sys.stderr) # Generate a unique DUID for the space space_duid = _make_duid() print(f"[Debug] Generated space DUID: {space_duid}", file=sys.stderr) # Create the space object with required fields space = SpaceCreate( duid=space_duid, order="0", title=args.get("title"), description=args.get("description", ""), drafter_duid=user_duid, # Set drafter_duid explicitly accessible_by_team=args.get("accessible_by_team", True), accessible_by_user_duids=args.get("accessible_by_user_duids", []), icon_kind=IconKind(args.get("icon_kind", "None")), icon_name_or_emoji=args.get("icon_name_or_emoji", "") ) print(f"[Debug] Created space object: {space}", file=sys.stderr) # Create the operation space_op = Operation( model=OperationModelKind.SPACE, kind=OperationKind.CREATE, data=space # Pass the SpaceCreate object ) print(f"[Debug] Created operation: {space_op}", file=sys.stderr) # Execute the transaction result = client.transact([space_op], TransactionKind.SPACE_CREATE) print(f"[Debug] Transaction completed", file=sys.stderr) if result.results and result.results[0].success: space = result.results[0].models.spaces[0] print(f"Space created successfully") print(f"Title: {space.title}") print(f"DUID: {space.duid}") print(f"[Debug] Space DUID: {space.duid}", file=sys.stderr) else: print("[Debug] Space creation failed", file=sys.stderr) if result.results: print(f"[Debug] Result: {result.results[0]}", file=sys.stderr) sys.exit(1)`; // Add proper indentation to the Python code const command = pythonCode.split('\n').map(line => { if (line.trim().length === 0) return line; return ' ' + line; }).join('\n'); console.error('[Debug] Running Python command for space creation'); const output = await this.runDartCommand(command); console.error('[Debug] Space creation output:', output); const response = { content: [{ type: 'text', text: output, }], }; return response; }
• src/index.ts:123-227 (helper)

  Helper method runDartCommand used by all tools including create_space. Spawns a Python process with a template script that initializes Dart client/session/bundle and executes custom Python code (args) in run_command function. Imports include SpaceCreate.
  async runDartCommand(args) { return new Promise((resolve, reject) => { // Use pyenv Python const pythonPath = '/Users/speed/.pyenv/shims/python'; console.error('[Debug] Running Python command with:', pythonPath); const command = `import sys import os import traceback import json from dart import Dart, Operation, OperationKind, OperationModelKind, TaskCreate, TaskUpdate, TransactionKind, TaskSourceType, SpaceCreate from dart.generated.types import UNSET from dart.dart import _Session, UserBundle, _make_duid from dart.generated.models.icon_kind import IconKind from dart.generated.models.sprint_mode import SprintMode from dart.generated.models.validation_error_response import ValidationErrorResponse def initialize(): print("[Debug] Starting Python execution", file=sys.stderr) print("[Debug] Current directory:", os.getcwd(), file=sys.stderr) print("[Debug] PYTHONPATH:", os.environ.get('PYTHONPATH'), file=sys.stderr) print("[Debug] DART_TOKEN:", os.environ.get('DART_TOKEN'), file=sys.stderr) session = _Session() print("[Debug] Session created", file=sys.stderr) bundle = UserBundle(session) print("[Debug] UserBundle created", file=sys.stderr) dartboard_duid = bundle.default_dartboard["duid"] print(f"[Debug] Got dartboard DUID: {dartboard_duid}", file=sys.stderr) client = Dart() print("[Debug] Dart client created", file=sys.stderr) return client, bundle, dartboard_duid def run_command(client, bundle, dartboard_duid): ${args} def main(): client, bundle, dartboard_duid = initialize() run_command(client, bundle, dartboard_duid) try: main() except Exception as e: print(f"Error: {str(e)}", file=sys.stderr) traceback.print_exc(file=sys.stderr) sys.exit(1)`; console.error('[Debug] Python command:', command); // Create a clean environment without virtual env variables const env = { ...process.env }; delete env.VIRTUAL_ENV; delete env.CONDA_PREFIX; delete env.CONDA_DEFAULT_ENV; delete env.CONDA_PYTHON_EXE; const childProcess = spawn(pythonPath, ['-c', command], { env: { ...env, PYTHONUNBUFFERED: '1', PYTHONPATH: process.env.PYTHONPATH || process.cwd(), DART_TOKEN: process.env.DART_TOKEN, }, stdio: ['pipe', 'pipe', 'pipe'], }); let output = ''; let errorOutput = ''; childProcess.stdout?.on('data', (data) => { const str = data.toString(); console.error('[Debug] Python stdout:', str); output += str; }); childProcess.stderr?.on('data', (data) => { const str = data.toString(); console.error('[Debug] Python stderr:', str); errorOutput += str; }); childProcess.on('error', (error) => { console.error('[Debug] Python process error:', error); reject(new Error(`Failed to start Python process: ${error.message}`)); }); // Add timeout const timeout = setTimeout(() => { console.error('[Debug] Python command timed out'); childProcess.kill(); reject(new Error('Command timed out')); }, 30000); // 30 second timeout childProcess.on('close', (code) => { clearTimeout(timeout); console.error(`[Debug] Python process exited with code ${code}`); if (code === 0) { resolve(output.trim()); } else { reject(new Error(errorOutput || `Command failed with exit code ${code}`)); } }); }); }