find_similar_apis

Instructions

Implementation Reference

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

  The core handler function that proxies tool execution to the external Xiaobenyang API by making an HTTP POST request with the tool name and arguments. This implements the logic for 'find_similar_apis' and all other dynamically registered 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 ('find_similar_apis'), then delegates to the core proxy function.

  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)

  Registers a single tool with the MCP server, specifying name, description, input schema, and the proxy handler. Called for each tool including 'find_similar_apis'.

  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:87-134 (registration)

  Dynamically fetches the list of tools (including 'find_similar_apis') from the external API, constructs Zod schemas from their descriptions, and registers them using addToolXiaoBenYangApi.

  const data = await res.json();
  const apiDescList = data.tools;
  
  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.bigint();
                  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);
  }
  isRegistered = true;
  state.isLoading = false;

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

  Constructs the input schema (Zod types) dynamically from the JSON schema fetched for each tool, mapping types like string, number, etc., and handling required/optional fields.

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