Discogs MCP Server

Instructions

Implementation Reference

• src/tools/database.ts:198-213 (handler)

  The main handler for the 'get_release_community_rating' tool. It instantiates ReleaseService and calls getCommunityRating(args), returning the JSON stringified result or formatted error.

  export const getReleaseCommunityRatingTool: Tool<FastMCPSessionAuth, typeof ReleaseIdParamSchema> =
    {
      name: 'get_release_community_rating',
      description: 'Retrieves the release community rating average and count',
      parameters: ReleaseIdParamSchema,
      execute: async (args) => {
        try {
          const releaseService = new ReleaseService();
          const releaseRating = await releaseService.getCommunityRating(args);
  
          return JSON.stringify(releaseRating);
        } catch (error) {
          throw formatDiscogsError(error);
        }
      },
    };

• src/types/release.ts:147-149 (schema)

  Input schema for the tool, defining the required 'release_id' parameter as a positive integer.

  export const ReleaseIdParamSchema = z.object({
    release_id: z.number().min(1, 'The release_id must be non-zero'),
  });

• src/tools/database.ts:253-266 (registration)

  Registers the getReleaseCommunityRatingTool (and other database tools) with the FastMCP server.

  export function registerDatabaseTools(server: FastMCP): void {
    server.addTool(getReleaseTool);
    server.addTool(getReleaseRatingTool);
    server.addTool(editReleaseRatingTool);
    server.addTool(deleteReleaseRatingTool);
    server.addTool(getReleaseCommunityRatingTool);
    server.addTool(getMasterReleaseTool);
    server.addTool(getMasterReleaseVersionsTool);
    server.addTool(getArtistTool);
    server.addTool(getArtistReleasesTool);
    server.addTool(getLabelTool);
    server.addTool(getLabelReleasesTool);
    server.addTool(searchTool);
  }