@interviewsage/mcp
This server provides AI-powered job-search assistance through MCP tools for resume, interviews, written-test practice, and career assessment.
health– verify API key validity and current membership tier.search_articles– search job-hunting methodology articles by keyword.holland_assessment– deliver a 60-question Holland career interest assessment and return a RIASEC code with interpretation.interview_questions_bank– browse question categories, draw written-test questions, and submit answers for grading and explanations.resume_diagnose– diagnose a resume with an overall score, five-dimension ratings, strengths, problems, and improvement suggestions.resume_rewrite– rewrite resume experiences using STAR and better wording.resume_tailor– tailor a resume to match a target job description and highlight relevant keywords/experiences.interview_coach– score an interview answer and provide strengths, improvements, and a reference answer.interview_prediction– predict interview questions for a specific company/role with answers, approaches, and follow-ups.ocr_exam_search– upload a question image as base64, OCR the question, and return the answer and explanation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@interviewsage/mcpCan you give me a mock interview for a data analyst position?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
面面星 MCP Server · InterviewSage MCP
AI 求职辅导工具 · AI-powered job-search assistant for the Model Context Protocol
InterviewSage MCP (@interviewsage/mcp) is a Model Context Protocol (MCP) server that brings AI-powered job-search assistance — resume diagnosis, resume rewriting, job tailoring, interview question prediction, written-test question banks, and Holland career assessment — directly into AI assistants like Claude Desktop, Cursor, and Tencent WorkBuddy. It turns plain-language requests (e.g. "帮我诊断这份简历") into professional, actionable job-hunting results.
面面星 MCP(@interviewsage/mcp)是一个 Model Context Protocol (MCP) server,把面面星(InterviewSage)的 简历诊断、简历改写、岗位定制、面试押题、笔试真题、霍兰德职业测评 等求职辅导能力,接入你日常使用的 AI 助手——Claude Desktop、Cursor、腾讯 WorkBuddy 等。从此你可以直接用自然语言让 AI 帮你写简历、刷笔试、练面试。
面向人群:求职中的应届生、社招转行者、想系统准备笔试面试的求职者,以及希望把求职能力嵌入自己 AI 工作流的人。
目录
Related MCP server: AI Job Intelligence MCP
这是什么?
面面星 MCP 是一座「桥」:一端是你熟悉的 AI 助手,另一端是面面星的服务端求职智能。你在 AI 里用中文说一句需求(比如「帮我诊断这份简历」),AI 就会调用对应的工具,把结果组织成可读的答案返回给你。
一句话理解:AI 负责对话和理解,面面星负责专业的求职能力(简历打分、简历改写、面试出题、笔试判分、职业测评)。
⚠️ 保密说明:本仓库是一个极薄的 relay,只包含工具声明、入参 schema、HTTP 转发与鉴权。简历打分、匹配机制、LLM prompt、自动填写选择器等核心逻辑全部在服务端,不在此仓库,也不开源。详见保密声明。
为什么选面面星?
优势 | 说明 |
免费层真实可用 | 4 个免费工具(干货检索 / 霍兰德测评 / 笔试真题 / 权益查询)+ 1 次简历诊断免费试用,零门槛先体验 |
服务端智能 | 核心算法与模型在服务端统一维护,所有用户用到的是同一套最新能力;relay 零业务逻辑、开源可审计 |
一键接入 |
|
懂国内求职 | 中文简历、中文面试、行测/大厂笔试真题、霍兰德职业测评,贴合国内求职真实场景 |
能力一览
面面星 MCP 提供 10 个工具,按档位分级:
档位 | 工具 | 一句话能力 |
免费 |
| 查权益、搜干货、做测评、刷真题 |
试用 |
| 简历综合诊断(首次免费) |
会员 |
| 改写简历、定制岗位、单面陪练、面试押题 |
Pro |
| 拍照搜题(月度额度) |
完整能力与入参见工具详解。
快速开始
1. 生成 API Key
打开面面星网页端 https://www.interviewsage.cn
登录后进入「会员中心 → API 密钥」
点击「生成」,复制返回的
mmx_开头的密钥(只显示一次,请妥善保存)
2. 配置你的 AI 客户端
Claude Desktop / Cursor
编辑配置文件,加入 interviewsage:
// claude_desktop_config.json
{
"mcpServers": {
"interviewsage": {
"command": "npx",
"args": ["-y", "@interviewsage/mcp"],
"env": {
"INTERVIEWSAGE_API_KEY": "mmx_你的密钥",
"INTERVIEWSAGE_BASE_URL": "https://www.interviewsage.cn"
}
}
}
}腾讯 WorkBuddy
编辑 ~/.workbuddy/mcp.json(Windows:C:\Users\你的用户名\.workbuddy\mcp.json):
{
"mcpServers": {
"interviewsage": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@interviewsage/mcp"],
"env": {
"INTERVIEWSAGE_API_KEY": "mmx_你的密钥",
"INTERVIEWSAGE_BASE_URL": "https://www.interviewsage.cn"
}
}
}
}配置后到 WorkBuddy 连接器管理页找到「interviewsage」,点击「信任」后刷新即可。
其他 MCP 客户端
任何支持 MCP(stdio transport)的客户端都可接入,配置方式同上(command: npx + args: -y @interviewsage/mcp + 环境变量)。
使用场景 & 对话示例
以下示例展示了你在 AI 助手里的典型用法。AI 会识别你的意图并自动调用对应工具。
场景 1:简历诊断 Resume Diagnosis(免费试用)
你:这是我应届生的简历,帮我诊断一下有哪些问题、怎么改 (附上简历全文)
AI(调用
resume_diagnose):综合评分 68/100,五个维度分别是……主要问题有 3 点……建议……
场景 2:简历改写 Resume Rewriting(会员)
你:把我的实习经历用 STAR 法则改写,突出量化成果
AI(调用
resume_rewrite):改后把「负责 XX」改成了「通过 XX 动作,实现 XX 结果,提升 XX%」……
场景 3:岗位定制 Job Tailoring(会员)
你:我投腾讯的产品经理岗,按这个 JD 定制我的简历 (附上 JD 全文)
AI(调用
resume_tailor):命中关键词「用户增长、数据分析、跨团队协作」……定制后简历突出这些匹配点……
场景 4:面试押题 Interview Prediction(会员)
你:我要面字节跳动的后端开发岗,帮我预测会被问什么题
AI(调用
interview_prediction):预测 8 道题,附参考答案、答题思路与可能追问……
场景 5:笔试刷题 Written-test Practice(免费)
你:帮我抽几道行测「数量关系」的题练练
AI(调用
interview_questions_bank):抽出 10 题(不含答案)……你作答后它判分并给出解析。
场景 6:职业测评 Career Assessment(免费)
你:帮我测测我适合什么职业方向
AI(调用
holland_assessment):先下发 60 道兴趣题……作答后返回三字母职业代码与完整解读报告。
工具详解
工具名 Tool | 功能 What it does | 档位 Tier | 解决什么痛点 |
| 连通性 + 权益回显 | 免费 | 验证 key 是否有效、当前套餐档位 |
| 求职干货检索 | 免费 | 关键词检索简历/面试/笔试/职业规划方法论文章,零 AI 成本 |
| 霍兰德职业测评 | 免费 | 60 题兴趣测评,返回三字母代码 + 解读报告,帮选职业方向 |
| 笔试真题库 | 免费 | 分类树 / 抽题(不含答案)/ 判分解析,覆盖行测与名企真题 |
| 快速简历诊断 | 免费试用 1 次 | 综合评分 + 五维打分 + 亮点/问题/建议,找简历硬伤 |
| 简历改写 | 会员 | STAR 重构经历、优化措辞,把流水账改成结果链 |
| 岗位定制 | 会员(35 积分) | 按目标 JD 定制简历,突出匹配关键词与经历 |
| 单面陪练点评 | 会员 | 对某道面试题的回答打分,给亮点/改进点/参考回答 |
| 面试押题 | 会员 | 按公司/岗位预测面试题,附参考答案与思路 |
| OCR 拍照搜题 | Pro(月度额度) | 上传题目图片,识别题干并返回答案与解析 |
会员级能力(简历改写、岗位定制、单面陪练、面试押题等)通过服务端会员门禁控制;被拒时 AI 会展示开通链接(upgradeUrl)。OCR 拍照搜题为 Pro 专属。
支持的 AI 客户端
客户端 | 接入方式 | 说明 |
Claude Desktop |
| 官方 MCP 支持 |
Cursor | 同上 | 官方 MCP 支持 |
腾讯 WorkBuddy | stdio( | 国内 PC 端 AI 办公智能体 |
其他 MCP 客户端 | stdio transport | 任何实现 MCP 协议的客户端均可 |
除 stdio 外,远程(Streamable HTTP)直连方式也在上线中,届时无需本地
npx即可连接。
环境变量
变量 | 必填 | 默认值 | 说明 |
| 是 | — | 面面星网页端生成的 API key( |
| 否 |
| 服务端地址,一般无需改 |
常见问题 FAQ
Q:免费和会员有什么区别? A:免费含 4 个工具(health / search_articles / holland_assessment / interview_questions_bank)+ resume_diagnose 首次免费试用。会员解锁 resume_rewrite / resume_tailor(35 积分)/ interview_coach / interview_prediction;Pro 额外解锁 ocr_exam_search(月度额度)。被门禁拦截时 AI 会展示开通链接。
Q:我的简历数据会去哪? A:你在 AI 里输入的简历文本会通过 HTTPS 传到面面星服务端处理,用于生成诊断/改写结果。relay 本身不存储、不解析你的数据——它只是一条加密通道。数据安全由面面星服务端保障。
Q:API key 安全吗? A:面面星服务端只存 key 的 SHA-256 哈希,不存明文;明文仅在创建时显示一次。若泄露,可在网页端「API 密钥」页随时撤销并重新生成。
Q:为什么核心逻辑在服务端,而不是开源? A:简历打分、匹配机制、LLM prompt 等是面面星的核心商业能力,需统一维护以保证所有用户用同一套最新模型。开源的是 relay 层(工具声明 + 转发),你完全可以审计它不会偷看或篡改你的数据。
Q:key 会过期吗? A:默认长期有效,可在网页端随时撤销。建议定期轮换以降低泄露风险。
Q:会收费吗? A:本 relay 完全免费开源(MIT)。面面星会员是另一回事,一个身份在网页端与 MCP 端通用。
Q:我的 key 用不了怎么办? A:到网页端「API 密钥」页确认 key 未撤销、未过期、未禁用;重新生成一把试试。
本地开发
npm install
npm run build # 编译 TypeScript 到 dist/
npm run dev # 直接跑源码(tsx)运行(需先设置环境变量):
INTERVIEWSAGE_API_KEY=mmx_xxx npx -y @interviewsage/mcp保密声明
本仓库是面面星 MCP 的薄 relay 客户端,仅包含:
工具声明与入参 schema(zod)
HTTP 转发(拼 URL + 加鉴权头 + 错误透传)
展示层格式化(把服务端返回的结构化数据渲染成文本)
不包含任何核心业务逻辑:简历打分、匹配机制、LLM prompt、自动填写选择器等均在面面星服务端,不在此仓库、不开源。
License
MIT。本仓库为薄 relay,不含面面星任何核心业务逻辑。
Available Tools
10 toolshealthA
检查面面星 MCP 连接与当前 API key 的会员权益状态(免费)。用于验证 key 是否有效、当前套餐档位。
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden, and it communicates that this is a diagnostic, read-only operation ('检查', '验证') and that it is free ('免费'). It does not detail the response format, but for a zero-parameter health check the main behavioral traits are adequately disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence that states the action, target, and diagnostic purpose without any filler. Every clause adds meaningful information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter health check with no output schema, the description covers what is checked and why. It stops short of specifying the exact response shape, but that is a minor omission given the simple diagnostic nature of the tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters and schema coverage is trivially 100%, so the baseline is 4. There are no parameter semantics to add beyond what the empty schema already conveys.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb '检查' (check) and names two concrete resources: the MCP connection and the membership entitlement status of the current API key. This clearly separates it from the sibling tools, which are all content-generation or assessment operations.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description states the intended use case explicitly: '用于验证 key 是否有效、当前套餐档位' (to verify key validity and current plan tier). It does not mention exclusions or alternatives, but no sibling tool performs a health-check role, so the usage context is clear enough without them.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
holland_assessmentA
霍兰德职业兴趣测评(免费,规则计算)。不传 answers 时下发 60 道题;提交 60 题答案后返回三字母职业代码与完整解读报告。
| Name | Required | Description | Default |
|---|---|---|---|
| answers | No | 60 题答案数组;留空则只下发题目 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden and does it well: it states the tool is free, uses deterministic rule-based calculation, and defines what happens in each mode based on whether answers are provided. It does not discuss partial answer sets, but schema constraints already cover the 60-item limit and score range.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence with no filler. The primary rule is front-loaded, and the conditional behavior is stated efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-optional-parameter tool with no output schema, the description covers how to start, how to complete, and what result format to expect. The only notable gap is explicit handling of incomplete answer sets, but the schema's maxItems constraint partially mitigates this.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds value by linking the presence or absence of the answers parameter to completely different outputs. It also clarifies that a full submission of 60 answers is what triggers the career code and report.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific resource (Holland career interest assessment) and defines a clear two-mode behavior: return 60 questions when answers are absent, or return a three-letter code and full report when 60 answers are submitted. This clearly distinguishes it from the sibling resume, interview, and search tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description makes invocation context explicit: call without answers to fetch the question set, call with answers to obtain the scored interpretation. It does not explicitly name alternatives, but the sibling tools are in clearly different domains, so no exclusion is strictly necessary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
interview_coachA
单面陪练点评(会员)。对某道面试题的回答打分,并给出亮点、改进点与参考回答。需会员。
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | 面试题 | |
| resumeText | No | 简历全文(可选,用于个性化点评) | |
| userAnswer | Yes | 你的回答 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the transparency burden. It discloses membership requirements, the core scoring behavior, and the return content (score, highlights, improvement suggestions, reference answer). It could add more context about how the evaluation is generated, but the essential behavior is clear.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One compact sentence plus a membership note. Every phrase carries information: function, target input, output categories, and access level. The only slight redundancy is '(会员)' and '需会员', but it is minor and reinforces an important constraint.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity tool with fully documented parameters and no output schema, the description provides enough operational context: required/optional inputs, membership, and expected output types. It lacks explicit routing guidance against sibling tools and a precise output structure, but those are modest gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents question, userAnswer, and optional resumeText. The main description adds no parameter-level detail beyond the schema, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific action ('对某道面试题的回答打分') and a concrete resource ('某道面试题的回答'). It also enumerates outputs (亮点、改进点、参考回答), making it easy to distinguish from siblings like interview_questions_bank (generates questions) and resume_tailor/rewrite (work on resumes).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly implies the use case: evaluate a user's answer to an interview question and provide feedback. It also states an access condition ('需会员'), which is a useful exclusion for non-members. It does not explicitly name alternatives or when-not-to-use conditions, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
interview_predictionA
面试押题(会员)。根据公司与岗位预测可能被问到的面试题,附带参考答案、答题思路与追问。需会员。
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | 题目数量,默认 8 | |
| jobTitle | Yes | 岗位名 | |
| resumeText | No | 简历全文(可选,用于个性化出题) | |
| companyName | Yes | 公司名 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the disclosure burden. It clearly discloses the membership requirement ('需会员') and what the response contains (reference answers, answering ideas, and follow-up questions). It does not explicitly discuss non-mutating behavior, but the predictive phrasing makes that evident; minor gaps remain around failure behavior for non-members, but the key constraints are visible.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two compact sentences with no filler: the core purpose is front-loaded, the deliverables are listed in one clause, and the membership gate is stated last. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a generation tool with a required company and job title, the description is largely complete: it names the inputs from the schema, describes the output components, and flags the membership constraint. Because there is no output schema, it wisely describes the return content. It could add guidance on the optional resumeText personalization or the default count, but those are covered by the input schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description's phrase '根据公司与岗位' mirrors the required companyName and jobTitle parameters but does not add extra meaning about count or resumeText; the schema already documents those. The description neither compensates beyond schema nor omits critical parameter context.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('预测可能被问到的面试题'), the resource (interview questions tailored to a company and job title), and the deliverables (reference answers, answering approaches, follow-up questions). This clearly distinguishes it from sibling tools like interview_questions_bank, which suggests a generic question repository rather than company-specific prediction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use the tool: when a user wants predicted interview questions for a specific company and job title, and it warns that membership is required. However, it does not provide explicit when-to-use/when-not-to-use guidance or mention alternatives such as interview_questions_bank or interview_coach, so an agent must infer the appropriate routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
interview_questions_bankA
笔试真题库(免费)。action=sections 查看分类树;action=questions 按大类/企业抽题(不含答案);action=check 提交答案并返回正误、正确答案与解析。
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | 抽题数量,默认 10 | |
| action | Yes | sections=查看分类树 / questions=抽题(不含答案)/ check=提交答案判分 | |
| company | No | 企业真题来源,如 kimberly / chinamobile | |
| section | No | 行测大类,如 verbal / quantitative / judgment / data_analysis / professional | |
| difficulty | No | 难度 1-5 | |
| questionId | No | check 时必填:题目 id | |
| subsection | No | 子题型 key | |
| userAnswer | No | check 时必填:所选选项 key(如 A/B/C/D) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden and does well: it discloses that the bank is free, that questions are drawn without answers, and that check returns correctness, the correct answer, and explanation. It does not cover edge cases or rate limits, but the core behavioral contract for an agent is clearly stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that front-loads the resource and then enumerates each action mode in a parallel structure. There is no filler and every clause contributes actionable information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Although the tool has 8 parameters and no output schema, the description plus rich schema is enough: each action's return behavior is stated (tree, questions without answers, check with explanations), and parameter constraints live in the schema. A small gap is that the description does not explicitly link that questions returns questionId for use by check, but this is inferable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3; the schema already documents action enums, count limits, company/section examples, and check-required fields. The description adds only a little by mapping '按大类/企业' to section/company, which reinforces but does not significantly extend the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names the resource (笔试真题库) and breaks the tool into three explicit actions: sections for the category tree, questions for drawing exam questions, and check for grading answers. This makes the tool's purpose unambiguous and clearly distinct from siblings like resume_rewrite or interview_coach.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear action-level routing: use sections to browse categories, questions to draw questions by section/company, and check to submit answers for grading. It does not explicitly state when to prefer this tool over sibling tools, but the internal action guidance is sufficient for correct use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ocr_exam_searchA
OCR 拍照搜题(Pro 专属,月度额度)。上传题目图片的 base64,识别题干并返回结构化题目、答案与解析。仅限合法学习用途。
| Name | Required | Description | Default |
|---|---|---|---|
| imageBase64 | Yes | 题目图片的 base64 编码(可含 data:image/...;base64, 前缀,建议 ≤ 6MB) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral disclosure burden. It transparently states that the tool performs OCR, consumes monthly quota, requires Pro access, and returns structured question/answer/explanation data. It also includes an acceptable-use restriction. It does not mention error behavior or data retention, but the core operation and resource implications are disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three concise sentences: the first names the tool and its access/quota context, the second explains input-process-output, and the third states the usage policy. Every sentence earns its place; no redundancy or verbose filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool with no output schema and no annotations, the description covers the input format, the operation, the return content, and access constraints. It does not describe possible failure cases or empty search results, but for the tool's simplicity the provided context is adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%: the imageBase64 parameter is already documented with format details (base64, optional data URI prefix, ≤6MB suggestion). The tool description only repeats '上传题目图片的 base64' without adding new semantic meaning, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states the verb and resource: 'OCR 拍照搜题' (upload base64 of question image, recognize question stem, return structured questions, answers and explanations). This clearly distinguishes the tool from its siblings, which are all resume, interview, or health related.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description communicates the intended trigger ('上传题目图片的 base64') and access constraints ('Pro 专属,月度额度', '仅限合法学习用途'). It does not name alternatives because none of the sibling tools overlap with OCR-based exam search, so no explicit exclusion is needed. A small gap is the lack of explicit guidance on when not to use it beyond the Pro/quota restriction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
resume_diagnoseA
快速简历诊断(免费试用 1 次)。输入简历全文,返回综合评分、五维打分、亮点、问题与可执行改进建议。首次免费,再次使用需开通会员。
| Name | Required | Description | Default |
|---|---|---|---|
| resumeText | Yes | 简历全文文本(纯文本) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the behavioral burden. It discloses the output structure and the access limitation (free once, then membership required), which are important behavioral constraints. It does not explicitly state that the operation is non-mutating, but the diagnostic action implies no modification.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences deliver the purpose, input, output, and usage restriction with no filler. Important information is front-loaded, and every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool with no output schema, the description is complete: it specifies what to pass in, what results to expect, and the access conditions. Nothing critical is missing for an agent to invoke it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage for the single parameter is 100%, so the schema already defines resumeText as plain resume full text with length limits. The description repeats this notion without adding new semantic detail, so it meets the baseline but does not exceed it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states a specific action (resume diagnosis), the required input (resume full text), and the returned outputs (overall score, five-dimension scores, strengths, issues, actionable suggestions). This clearly distinguishes it from siblings like resume_rewrite and resume_tailor.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description clearly communicates how to use the tool: feed the full resume text to receive a diagnosis, and notes the free-trial and membership requirement. However, it does not explicitly mention when not to use it or point to alternatives such as resume_rewrite or resume_tailor.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
resume_rewriteA
简历改写(会员)。用 STAR 法则重构经历、优化措辞,返回改写后的完整简历与改动说明。需会员。
| Name | Required | Description | Default |
|---|---|---|---|
| resumeText | Yes | 简历全文文本(纯文本) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral burden. It discloses the transformation approach (STAR), the return format (full resume and change explanation), and the access requirement (membership). It could say more about side effects or failure behavior, but for a text-transform tool these key behaviors are covered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler. It front-loads the core action, then adds method, output, and access requirements. Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter, stateless-seeming rewrite tool, the description is largely complete: it states inputs implied by schema, output structure, method, and membership restriction. It could be slightly more complete by naming when to use it instead of resume_tailor, but that gap is already reflected in the usage_guidelines score.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input parameter is already well documented as the full plain-text resume. The description does not add parameter-specific meaning beyond what the schema provides, which matches the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the operation: rewriting a resume using the STAR method and refining wording. It also names the output (full rewritten resume plus change notes), which helps distinguish it from diagnostic or interview-related siblings, though it does not explicitly contrast with resume_tailor or resume_diagnose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended use is implied: the agent should call this when the user requests a STAR-based resume rewrite. However, it does not explicitly say when to prefer this tool over resume_tailor or resume_diagnose, and it only offers a membership precondition rather than selection criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
resume_tailorA
岗位定制(会员,消耗 35 积分)。根据目标岗位 JD 定制简历,突出与之匹配的关键词与经历。需会员。
| Name | Required | Description | Default |
|---|---|---|---|
| jdText | Yes | 目标岗位 JD 全文(纯文本) | |
| resumeText | Yes | 简历全文文本(纯文本) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden of behavioral disclosure. It does disclose membership requirements and the 35-credit cost, which is useful, but it does not state whether the original resume is modified, what the output format is, or any other side effects or limitations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded, with membership and cost stated immediately. Every phrase contributes meaning, and there is no redundant filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with two plain-text string parameters, the schema handles input documentation well and the description covers purpose, cost, and membership. However, with no output schema, the description does not state the return format, and it does not clarify how this differs from the sibling resume_rewrite tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both resumeText and jdText clearly documented as plain-text resume and JD content. The description adds no additional parameter-level detail beyond restating the general purpose.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: tailoring a resume to a target job JD and highlighting matching keywords and experiences. It is specific and understandable, though it does not explicitly differentiate itself from the sibling tool resume_rewrite.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The use case is implied: use this when you have a target position JD and want a customized resume. However, there is no explicit guidance on when not to use it or how it compares to alternatives like resume_rewrite or resume_diagnose.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_articlesA
检索面面星求职干货文章(免费,零 AI)。输入关键词返回匹配的文章标题、摘要与阅读链接,覆盖简历、面试、笔试、职业规划等求职方法论。
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 返回条数,默认 10 | |
| query | Yes | 搜索关键词,例如「简历 自我介绍」 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral disclosure burden. It adds useful non-obvious details: the tool is free, uses zero AI, and returns only titles, summaries, and links. '检索' implies a read-only operation, and no destructive or side-effect behavior is suggested.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence with no filler. The primary purpose is front-loaded, and each phrase ('免费', '零 AI', '标题、摘要与阅读链接') adds useful information without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple search tool with two well-documented parameters and no output schema, the description is adequately complete: it states the purpose, input, and returned fields. It lacks explicit usage boundaries or sorting/pagination behavior, but these are not critical for this tool's complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description mentions '输入关键词' but this largely repeats the query parameter description already in the schema. It adds no meaningful detail about limit semantics or parameter interaction.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('检索') and resource ('求职干货文章'), and clearly states the return content (titles, summaries, links). It does not explicitly name or differentiate from sibling tools, but the article-focused resource makes the distinction inferable from tools like interview_questions_bank.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The intended usage is implied through '输入关键词返回匹配的文章' and the listed content areas, but there is no explicit when-to-use or when-not-to-use guidance, nor any mention of alternatives. An agent would have to infer when this is preferable to sibling tools like interview_coach or resume_rewrite.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
10 tool updates
v0.1.0- First observed
health - First observed
holland_assessment - First observed
interview_coach - First observed
interview_prediction - First observed
interview_questions_bank - First observed
ocr_exam_search - First observed
resume_diagnose - First observed
resume_rewrite - First observed
resume_tailor - First observed
search_articles
TDQS
Scored across 10 tools
Most tools map to clearly distinct functions (health, articles, assessment, OCR), but the three resume tools—diagnose, rewrite, tailor—are closely related and could be mixed up when choosing an action. interview_coach and interview_prediction are also adjacent, though their descriptions make the difference clear.
The tool names are all snake_case but follow no consistent pattern: some are verb-first (search_articles), some are noun-verb (resume_rewrite, resume_diagnose, resume_tailor), and several are noun phrases (health, holland_assessment, interview_questions_bank, interview_coach, interview_prediction, ocr_exam_search).
Ten tools is a well-scoped count for a career/interview assistant covering health checks, articles, assessment, resume services, interview practice, and OCR search. Each tool earns its place and none feel redundant.
The tool surface covers the full core workflow of the domain: discovery (articles, health), assessment (Holland), resume improvement (diagnose, rewrite, tailor), interview preparation (questions, coach, prediction), and OCR lookup. There are no obvious dead ends or missing lifecycle operations.
Maintenance
Related MCP Connectors
CareerProof MCP gives AI agents direct access to a professional-grade career and workforce intelligence platform. Two namespaces: atlas_* for HR/TA teams (candidate evaluation, batch shortlisting, competency scoring, interview generation, JD analysis, custom eval frameworks, research reports) and ceevee_* for professionals (CV optimization, career positioning, salary intelligence, market reports). Backed by RAG knowledge from 50+ premium research sources (McKinsey, BCG, HBR, Gartner, WEF)
AI-powered career tools: job search, skills intelligence, career roadmaps, and resume building.
Career assistant: resumes, job-match analysis, interview results and career memory.
- mcpOAuthcom.qarera
Search jobs, manage resumes, and track applications on Qarera from your AI chat client.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables career diagnosis by analyzing user skills and recommending suitable professions using Google Gemini and a RAG knowledge base of 10 professions.-
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to serve as a personal career analyst by searching, matching, and explaining job recommendations, managing job applications, and syncing public job boards through standardized MCP tools.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with HR and talent backend services through a unified MCP interface, supporting resume parsing, job analysis, skill matching, and composite candidate evaluation tools.-
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to prepare job-tailoring prompts, export tailored resumes to Google Docs, inspect job details, and retry pending evaluations through JSON-RPC 2.0 tools.-