CurrencyAndOil

Instructions

Implementation Reference

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

  This is the core handler function `calcXiaoBenYangApi` that implements the logic for all dynamic tools, including 'calculate_barrels_for_rub'. It constructs and sends a POST request to the remote API endpoint 'https://mcp.xiaobenyang.com/api' using the tool name and arguments, and formats the response 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:39-48 (handler)

  Wrapper function `handleXiaoBenYangApi` that prepares the arguments by adding the tool name and calls the core proxy handler. This is invoked by the registered tool handlers.

  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)

  Utility function `addToolXiaoBenYangApi` that registers each tool on the MCP server using the generic proxy handler, dynamic input schema, and description fetched from the remote API.

  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 registration loop that fetches tool descriptions from 'https://mcp.xiaobenyang.com/getMcpDesc?mcpId=1777316659852291', parses schemas into Zod validators, and registers all tools (including 'calculate_barrels_for_rub') 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:92-125 (schema)

  Dynamic schema construction: Parses JSON schema from remote API description and converts it to a Zod object for input validation of tools like 'calculate_barrels_for_rub'.

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