Band MCP Server

Instructions

Implementation Reference

• src/albums/tool.ts:94-107 (handler)

  The main handler function for the get_albums tool. It fetches photo albums from the BAND API using the provided band_key and returns the JSON response as text content.

  export async function handleToolCall(band_key: string) {
    const albumsData = await bandApiClient.get<AlbumsResponse>(
      "/v2/band/albums",
      { band_key }
    );
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(albumsData, null, 2),
        },
      ],
    };
  }

• src/albums/tool.ts:8-71 (schema)

  Defines the tool schema including input (band_key) and detailed output schema for the albums response structure.

  export const ToolDefinition: Tool = {
    name: "get_albums",
    description: "Get photo albums from a specific band in BAND.",
    inputSchema: {
      type: "object",
      properties: {
        band_key: {
          type: "string",
          title: "Band ID",
          description: "band ID",
        },
      },
      required: ["band_key"],
    },
    outputSchema: {
      type: "object",
      properties: {
        result_code: {
          type: "number",
          description: "Result code",
        },
        result_data: {
          type: "object",
          description: "Result data",
          properties: {
            paging: {
              type: "object",
              description: "Paging information",
            },
            items: {
              type: "array",
              description: "List of photo albums",
              items: {
                type: "object",
                properties: {
                  photo_album_key: {
                    type: "string",
                    description: "photo album identifier",
                  },
                  name: {
                    type: "string",
                    description: "album name",
                  },
                  photo_count: {
                    type: "number",
                    description: "number of photos in album",
                  },
                  cover_photo: {
                    type: "object",
                    description: "album cover photo information",
                  },
                  created_at: {
                    type: "number",
                    description: "album created time",
                  },
                },
              },
            },
          },
        },
      },
      required: ["result_code", "result_data"],
    },
  };

• src/tools.ts:60-61 (registration)

  Registers the get_albums tool in the main dispatcher switch statement, calling the albums module's handler.

  case "get_albums":
    return albums.handleToolCall(a.band_key as string);

• src/tools.ts:22-22 (registration)

  Includes the get_albums ToolDefinition in the exported bandTools array for tool listing and discovery.

  albums.ToolDefinition,

• src/albums/index.ts:1-5 (helper)

  Re-exports ToolDefinition and handleToolCall from tool.ts for use in the main tools.ts module.

  import {ToolDefinition, handleToolCall} from "./tool.js";
  
  const albums = {ToolDefinition, handleToolCall}
  
  export default albums;