MCP FishBase Server

Instructions

Implementation Reference

• src/index.ts:82-95 (registration)

  Registration of the 'get_distribution' tool in the MCP server's ListToolsRequestHandler, including name, description, and input schema.

  {
    name: "get_distribution",
    description: "Get distribution/occurrence information for a species",
    inputSchema: {
      type: "object",
      properties: {
        species_name: {
          type: "string",
          description: "Scientific name of the species",
        },
      },
      required: ["species_name"],
    },
  },

• src/index.ts:201-213 (handler)

  MCP CallToolRequestHandler case for 'get_distribution' that calls the FishBaseAPI.getDistribution method and returns JSON response.

  case "get_distribution":
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            await fishbaseAPI.getDistribution(args.species_name as string),
            null,
            2
          ),
        },
      ],
    };

• src/fishbase-api.ts:84-98 (handler)

  Core implementation of getDistribution in FishBaseAPI: retrieves species SpecCode, queries occurrence table, filters by SpecCode, handles errors.

  async getDistribution(speciesName: string): Promise<any[]> {
    try {
      const speciesData = await this.getSpecies(speciesName);
      if (speciesData.length === 0) {
        throw new Error(`Species not found: ${speciesName}`);
      }
      
      const specCode = speciesData[0].SpecCode;
      const distData = await this.queryTable('occurrence');
      
      return distData.filter((row: any) => row.SpecCode === specCode);
    } catch (error) {
      throw new Error(`Failed to get distribution data: ${error}`);
    }
  }

• src/index.ts:85-94 (schema)

  Input schema definition for the 'get_distribution' tool, specifying required 'species_name' parameter.

  inputSchema: {
    type: "object",
    properties: {
      species_name: {
        type: "string",
        description: "Scientific name of the species",
      },
    },
    required: ["species_name"],
  },