convert_resume_text

Convert plain text resumes into structured JSON Resume format by automatically identifying sections like personal information, work experience, and education for easier editing and formatting.

Instructions

将纯文本格式的简历内容转换为标准JSON Resume格式。系统会智能识别简历中的各个部分（如个人信息、工作经历、教育背景等），并按照国际通用的JSON Resume标准进行结构化处理，方便后续编辑和格式转换。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`resumeText`	Yes

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返回了结果，但无法转换为字符串展示（可能包含循环引用）";
  }
};

MCP Server for NovaCV