Windows Automation MCP Server

Instructions

Implementation Reference

• src/tools/mouse-keyboard.js:125-136 (handler)

  The primary handler function that executes the mouse movement logic using robotjs, supporting smooth or direct movement.

  moveMouse(x, y, smooth = false) {
    try {
      if (smooth) {
        this.robot.moveMouseSmooth(x, y);
      } else {
        this.robot.moveMouse(x, y);
      }
      return { success: true, position: { x, y }, message: '鼠标已移动' };
    } catch (error) {
      return { success: false, error: error.message };
    }
  }

• src/tools/mouse-keyboard.js:26-38 (schema)

  Tool definition including name, description, and input schema for validating arguments x, y, and optional smooth.

  {
    name: 'move_mouse',
    description: '移动鼠标到指定位置',
    inputSchema: {
      type: 'object',
      properties: {
        x: { type: 'number', description: 'X 坐标' },
        y: { type: 'number', description: 'Y 坐标' },
        smooth: { type: 'boolean', description: '是否平滑移动（可选）' },
      },
      required: ['x', 'y'],
    },
  },

• src/tools/mouse-keyboard.js:93-97 (registration)

  Registers 'move_mouse' as a supported tool by including it in the canHandle check list.

  canHandle(toolName) {
    const tools = ['move_mouse', 'mouse_click', 'type_text', 'press_key', 
                   'get_mouse_position', 'get_screen_size'];
    return tools.includes(toolName);
  }

• src/tools/mouse-keyboard.js:108-109 (handler)

  Dispatch in executeTool method that routes 'move_mouse' calls to the moveMouse handler.

  case 'move_mouse':
    return this.moveMouse(args.x, args.y, args.smooth);

• src/tools/mouse-keyboard.js:24-91 (registration)

  Primary registration point where the tool definitions are provided for the MCP protocol.

  getToolDefinitions() {
    return [
      {
        name: 'move_mouse',
        description: '移动鼠标到指定位置',
        inputSchema: {
          type: 'object',
          properties: {
            x: { type: 'number', description: 'X 坐标' },
            y: { type: 'number', description: 'Y 坐标' },
            smooth: { type: 'boolean', description: '是否平滑移动（可选）' },
          },
          required: ['x', 'y'],
        },
      },
      {
        name: 'mouse_click',
        description: '鼠标点击',
        inputSchema: {
          type: 'object',
          properties: {
            button: { type: 'string', enum: ['left', 'right', 'middle'], description: '按钮类型' },
            double: { type: 'boolean', description: '是否双击（可选）' },
          },
        },
      },
      {
        name: 'type_text',
        description: '输入文本',
        inputSchema: {
          type: 'object',
          properties: {
            text: { type: 'string', description: '要输入的文本' },
            delay: { type: 'number', description: '每个字符之间的延迟（毫秒，可选）' },
          },
          required: ['text'],
        },
      },
      {
        name: 'press_key',
        description: '按下键盘按键',
        inputSchema: {
          type: 'object',
          properties: {
            key: { type: 'string', description: '按键名称（如 enter, tab, escape）' },
            modifiers: { type: 'array', items: { type: 'string' }, description: '修饰键（如 control, shift, alt）' },
          },
          required: ['key'],
        },
      },
      {
        name: 'get_mouse_position',
        description: '获取当前鼠标位置',
        inputSchema: {
          type: 'object',
          properties: {},
        },
      },
      {
        name: 'get_screen_size',
        description: '获取屏幕尺寸',
        inputSchema: {
          type: 'object',
          properties: {},
        },
      },
    ];
  }