Dart MCP Server

Instructions

Implementation Reference

• src/index.ts:347-358 (registration)

  Registration of the get_folders tool in the ListTools response, including name, description, and input schema requiring space_duid

  name: 'get_folders',
  description: 'Get available folders',
  inputSchema: {
      type: 'object',
      properties: {
          space_duid: {
              type: 'string',
              description: 'Space DUID to get folders from',
          }
      },
      required: ['space_duid'],
  },

• src/index.ts:349-357 (schema)

  Input schema for get_folders tool

  inputSchema: {
      type: 'object',
      properties: {
          space_duid: {
              type: 'string',
              description: 'Space DUID to get folders from',
          }
      },
      required: ['space_duid'],

• src/index.ts:776-813 (handler)

  Handler implementation for get_folders tool. It generates Python code that imports and calls get_folders from the dart library with the provided space_duid, lists the folders, and returns the output via stdio.

                  case 'get_folders': {
                      console.error('[Debug] Handling get_folders request');
                      const pythonCode = `    # Get folders for the space
  print("[Debug] Getting folders", file=sys.stderr)
  try:
      # Get folders using the get_folders function from dart module
      space_duid = "${args.space_duid}"
      print(f"[Debug] Getting folders for space: {space_duid}", file=sys.stderr)
      from dart import get_folders
      folders = get_folders(space_duid, include_special=True)  # Include all folders
      print("[Debug] Got folders:", folders, file=sys.stderr)
      
      # Print folder titles or indicate no folders found
      if not folders:
          print("No folders found in this space")
      else:
          print("Available folders:")
          for folder in folders:
              print(f"- {folder.title} (DUID: {folder.duid}, Kind: {folder.kind})")
  except Exception as e:
      print(f"[Debug] Error getting folders: {str(e)}", file=sys.stderr)
      traceback.print_exc(file=sys.stderr)
      sys.exit(1)`;
  
                      // Add proper indentation to the Python code
                      const command = pythonCode.split('\n').map(line => line.length > 0 ? '    ' + line : line).join('\n');
  
                      console.error('[Debug] Running Python command for getting folders');
                      const output = await this.runDartCommand(command);
                      console.error('[Debug] Get folders output:', output);
                      const response = {
                          content: [{
                              type: 'text',
                              text: output,
                          }],
                      };
                      return response;
                  }