Philippine-Geocoding

Instructions

Implementation Reference

• src/mcp.ts:39-48 (handler)

  Generic handler executed for the 'get_province_barangays' tool. It receives arguments, appends the tool name, and proxies the request to the remote XiaoBenYang API.

  const handleXiaoBenYangApi = async (args: Record<string, any>, toolName: string) => {
      // 校验aid是否存在
      if (toolName === undefined || toolName === null) {
          throw new Error("缺少必要参数 'aid'");
      }
      // 合并参数
      const fullArgs = {...args, toolName: toolName};
      // 调用API
      return calcXiaoBenYangApi(fullArgs);
  };

• src/mcp.ts:15-36 (handler)

  Core HTTP request handler that sends the tool name ('get_province_barangays') and parameters to the remote API and formats the response as MCP tool output.

  const calcXiaoBenYangApi = async function (fullArgs: Record<string, any>) {
      // 发起 POST 请求
      let response = await fetch('https://mcp.xiaobenyang.com/api', {
          method: 'POST',
          headers: {
              'XBY-APIKEY': apiKey,
              'func': fullArgs.toolName,
              'mcpid': mcpID
          },
          body: new URLSearchParams(fullArgs)
      });
      const apiResult = await response.text();
  
      return {
          content: [
              {
                  type: "text",
                  text: apiResult // 将字符串结果放入 content 中
              }
          ]
      } as { [x: string]: unknown; content: [{ type: "text"; text: string }] };
  };

• src/mcp.ts:50-65 (registration)

  Registers the 'get_province_barangays' tool (called for each tool from remote list) with the MCP server, providing schema, description, and the generic handler.

  const addToolXiaoBenYangApi = function (
      name: string,
      desc: string,
      params: Record<string, ZodType>
  ) {
      server.registerTool(
          name,
          {
              title: name,
              description: desc,
              inputSchema: params,
          }
          ,
          async (args: Record<string, any>) => handleXiaoBenYangApi(args, name)
      )
  };

• src/mcp.ts:90-132 (registration)

  Dynamically fetches tool list from remote API for mcpID '1777316659371011' (which includes 'get_province_barangays') and registers each tool using addToolXiaoBenYangApi.

  for (const apiDesc of apiDescList) {
      let inputSchema = JSON.parse(apiDesc.inputSchema);
      const zodDict: Record<string, z.ZodTypeAny> = {};
  
      Object.entries(inputSchema.properties).forEach(([name, propConfig]) => {
          let zodType;
          let pt = (propConfig as { type: string }).type;
          switch (pt) {
              case 'string':
                  zodType = z.string();
                  break;
              case 'number':
                  zodType = z.number();
                  break;
              case 'boolean':
                  zodType = z.boolean();
                  break;
              case 'integer':
                  zodType = z.int32();
                  break;
              case 'array':
                  zodType = z.array(z.any());
                  break;
              case 'object':
                  zodType = z.object(z.any());
                  break;
              default:
                  zodType = z.any();
          }
  
          if (inputSchema.required?.includes(name)) {
              zodDict[name] = zodType;
          } else {
              zodDict[name] = zodType.optional();
          }
      });
  
  
      addToolXiaoBenYangApi(
          apiDesc.name,
          apiDesc.description ? apiDesc.description : apiDesc.name,
          zodDict);
  }

• src/mcp.ts:91-127 (schema)

  Dynamically generates Zod input schema for 'get_province_barangays' and other tools based on the properties and types from the remote tool description.

  let inputSchema = JSON.parse(apiDesc.inputSchema);
  const zodDict: Record<string, z.ZodTypeAny> = {};
  
  Object.entries(inputSchema.properties).forEach(([name, propConfig]) => {
      let zodType;
      let pt = (propConfig as { type: string }).type;
      switch (pt) {
          case 'string':
              zodType = z.string();
              break;
          case 'number':
              zodType = z.number();
              break;
          case 'boolean':
              zodType = z.boolean();
              break;
          case 'integer':
              zodType = z.int32();
              break;
          case 'array':
              zodType = z.array(z.any());
              break;
          case 'object':
              zodType = z.object(z.any());
              break;
          default:
              zodType = z.any();
      }
  
      if (inputSchema.required?.includes(name)) {
          zodDict[name] = zodType;
      } else {
          zodDict[name] = zodType.optional();
      }
  });