Philippine-Geocoding

Instructions

Implementation Reference

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

  Dynamic registration loop that fetches tool descriptions from https://mcp.xiaobenyang.com/getMcpDesc?mcpId=1777316659371011 and registers each tool, including "get_region_barangays", with their schemas and handlers.

  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:55-64 (registration)

  Registers the tool with MCP server, specifying name, description, inputSchema, and handler that calls handleXiaoBenYangApi with the tool name.

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

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

  Handler function for all XiaoBenYang tools. Validates toolName, merges args with toolName, and calls calcXiaoBenYangApi to proxy the request to the remote 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)

  Executes the tool by sending POST request to https://mcp.xiaobenyang.com/api with toolName as 'func' header (e.g., 'get_region_barangays'), apiKey, mcpId, and args as body. Returns the text response formatted as MCP content.

  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:91-125 (schema)

  Dynamically constructs Zod inputSchema for each tool based on JSON schema from remote API response.

  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();
      }
  });