convert_resume_text

Instructions

Implementation Reference

• src/index.ts:235-260 (handler)

  The MCP tool handler function for 'convert_resume_text'. It validates the input resumeText, calls novaCVService.convertTextToJsonResume(), formats the response using safeStringify, and handles errors by returning structured content.

  async ({ resumeText }, extra) => {
    if (!resumeText) {
      throw new Error("简历文本是必需的");
    }
    
    try {
      const result = await novaCVService.convertTextToJsonResume(resumeText);
      return {
        content: [
          {
            type: "text",
            text: safeStringify(result)
          }
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: "text",
            text: `错误: ${error.message || "未知错误"}`
          }
        ],
      };
    }
  }

• src/services/novacv.ts:149-192 (helper)

  Core helper method in NovaCVService that performs the actual API call to convert plain resume text to JSON Resume format via POST /api/v1/resumes/convert-text, normalizes the response structure, and handles errors.

  async convertTextToJsonResume(resumeText: string): Promise<any> {
    try {
      console.log("开始转换简历文本为JSON格式");
      const response = await this.client.post('/api/v1/resumes/convert-text', {
        resumeText
      });
      console.log("转换API响应状态码:", response.status);
      console.log("转换API响应头:", JSON.stringify(response.headers, null, 2));
      console.log("转换API响应数据类型:", typeof response.data);
      
      // 如果直接返回简历数据，自动包装为标准格式
      if (response.data && typeof response.data === 'object') {
        // 检查是否缺少标准响应结构
        if (!response.data.success && !response.data.data && !response.data.error) {
          // 检查是否是简历数据结构
          if (response.data.basics || response.data.work || response.data.education) {
            return {
              success: true,
              data: {
                jsonResume: response.data
              }
            };
          }
        } 
        // 标准化响应 - 确保jsonResume数据在一致的位置
        else if (response.data.success && response.data.data) {
          // 如果有data.resumeData但没有data.jsonResume，复制数据
          if (response.data.data.resumeData && !response.data.data.jsonResume) {
            response.data.data.jsonResume = response.data.data.resumeData;
          }
          // 如果有data.jsonResume但没有data.resumeData，复制数据
          else if (response.data.data.jsonResume && !response.data.data.resumeData) {
            response.data.data.resumeData = response.data.data.jsonResume;
          }
        }
      }
      
      return response.data;
    } catch (error) {
      console.error("转换简历文本失败:", error);
      this._handleError(error);
      throw error;
    }
  }

• src/index.ts:229-261 (registration)

  Registration of the 'convert_resume_text' tool with the MCP server using server.tool(), including name, description, input schema, and handler reference.

  server.tool(
    "convert_resume_text",
    "将纯文本格式的简历内容转换为标准JSON Resume格式。系统会智能识别简历中的各个部分（如个人信息、工作经历、教育背景等），并按照国际通用的JSON Resume标准进行结构化处理，方便后续编辑和格式转换。",
    {
      resumeText: z.string()
    },
    async ({ resumeText }, extra) => {
      if (!resumeText) {
        throw new Error("简历文本是必需的");
      }
      
      try {
        const result = await novaCVService.convertTextToJsonResume(resumeText);
        return {
          content: [
            {
              type: "text",
              text: safeStringify(result)
            }
          ],
        };
      } catch (error: any) {
        return {
          content: [
            {
              type: "text",
              text: `错误: ${error.message || "未知错误"}`
            }
          ],
        };
      }
    }
  );

• src/index.ts:232-234 (schema)

  Zod input schema for the tool: requires a single string parameter 'resumeText'.

  {
    resumeText: z.string()
  },

• src/index.ts:90-110 (helper)

  Utility function safeStringify used in tool handlers to safely convert API responses to displayable strings, handling errors and special cases.

  const safeStringify = (data: any): string => {
    try {
      // 特别处理API错误响应
      if (data && data.error) {
        return `API错误: ${data.error.message || JSON.stringify(data.error)}`;
      }
      
      // 处理标准成功响应
      if (data && data.success === true && data.data) {
        const responseData = data.data;
        if (responseData.fileUrl) {
          return `简历生成成功，下载地址: ${responseData.fileUrl}`;
        }
      }
      
      // 默认JSON字符串化
      return JSON.stringify(data, null, 2);
    } catch (err) {
      return "API返回了结果，但无法转换为字符串展示（可能包含循环引用）";
    }
  };