MCP FishBase Server

Instructions

Implementation Reference

• src/index.ts:187-199 (handler)

  MCP CallToolRequest handler for the 'get_ecology' tool. It calls fishbaseAPI.getEcology with the species_name argument and returns the result as JSON-formatted text content.

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

• src/index.ts:68-81 (registration)

  Registration of the 'get_ecology' tool in the ListTools response, including its name, description, and input schema definition.

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

• src/fishbase-api.ts:68-82 (helper)

  Core logic for retrieving ecology data: fetches species to get SpecCode, queries the 'ecology' table, and filters rows matching the species.

  async getEcology(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 ecoData = await this.queryTable('ecology');
      
      return ecoData.filter((row: any) => row.SpecCode === specCode);
    } catch (error) {
      throw new Error(`Failed to get ecology data: ${error}`);
    }
  }