S3 MCP Server

Instructions

Implementation Reference

• src/index.ts:158-169 (handler)

  Handler implementation for the 's3_list_buckets' tool. Executes ListBucketsCommand via s3Client and returns JSON stringified list of buckets.

  case "s3_list_buckets": {
    const command = new ListBucketsCommand({});
    const response = await s3Client.send(command);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response.Buckets || [], null, 2),
        },
      ],
    };
  }

• src/index.ts:64-70 (registration)

  Tool registration in ListToolsRequestHandler response, defining name, description, and input schema (empty object).

    name: "s3_list_buckets",
    description: "List all S3 buckets",
    inputSchema: {
      type: "object",
      properties: {},
    },
  },

• src/index.ts:66-69 (schema)

  Input schema definition for 's3_list_buckets' tool: empty object (no parameters required).

  inputSchema: {
    type: "object",
    properties: {},
  },

• src/index.ts:30-37 (helper)

  S3Client instance configuration, used by the handler to send ListBucketsCommand.

  const s3Client = new S3Client({
    region: S3_REGION,
    endpoint: S3_ENDPOINT,
    credentials: {
      accessKeyId: S3_ACCESS_KEY_ID,
      secretAccessKey: S3_SECRET_ACCESS_KEY,
    },
  });