Philippine-Geocoding

Instructions

Implementation Reference

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

  Core handler logic that executes the tool by proxying the request to the remote API endpoint 'https://mcp.xiaobenyang.com/api' using the tool name 'get_region_municipalities' and arguments. This is the implementation shared by all dynamic tools.

  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:39-48 (handler)

  Wrapper handler that validates and prepares arguments by adding the toolName 'get_region_municipalities', then calls the core API proxy.

  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:50-65 (registration)

  Registration helper that calls server.registerTool for a given tool name (e.g., 'get_region_municipalities'), description, and schema, using 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:89-132 (registration)

  Dynamic tool registration loop: fetches tool list from remote API (https://mcp.xiaobenyang.com/getMcpDesc?mcpId=1777316659371011), parses schemas, and registers all tools including 'get_region_municipalities'.

  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:94-126 (schema)

  Dynamic input schema construction using Zod based on JSON schema from remote tool description for 'get_region_municipalities'.

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