Scrapybara MCP

Instructions

Implementation Reference

• src/index.ts:181-204 (handler)

  Handler for the 'bash' MCP tool: parses arguments using BashSchema, retrieves Scrapybara instance, calls instance.bash(command), and returns the response.

  case "bash": {
    const args = BashSchema.parse(request.params.arguments);
    const instance = await client.get(args.instance_id, {
      abortSignal: currentController.signal,
    });
  
    if ("bash" in instance) {
      const response = await instance.bash(
        { command: args.command },
        { abortSignal: currentController.signal }
      );
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2),
          } as TextContent,
        ],
      };
    } else {
      throw new Error("Instance does not support bash commands");
    }
  }

• src/schemas.ts:18-23 (schema)

  Zod schema defining input for bash tool: instance_id (string) and command (string). Used for validation in handler and JSON schema in registration.

  export const BashSchema = z.object({
    instance_id: z
      .string()
      .describe("The ID of the instance to run the command on."),
    command: z.string().describe("The command to run in the instance shell."),
  });

• src/index.ts:89-92 (registration)

  Tool registration in listTools response: defines name 'bash', description, and input schema derived from BashSchema.

    name: "bash",
    description: "Run a bash command in a Scrapybara instance.",
    inputSchema: zodToJsonSchema(BashSchema),
  },