Skip to main content
Glama
gowing111

@interviewsage/mcp

by gowing111

面面星 MCP Server(@interviewsage/mcp)

把面面星(InterviewSage)的求职辅导能力接入你常用的 AI 助手(Claude Desktop / Cursor / 腾讯 WorkBuddy 等),让它直接调用「查干货、做测评、刷笔试真题」等能力。

⚠️ 保密说明:本仓库是一个极薄的 relay,只包含工具声明、入参 schema、HTTP 转发与鉴权。简历打分、匹配机制、LLM prompt、自动填写选择器等核心逻辑全部在服务端,不在此仓库,也不开源。


快速开始

1. 生成 API Key

  1. 打开面面星网页端 https://www.interviewsage.cn

  2. 登录后进入「会员中心 → API 密钥」

  3. 点击「生成」,复制返回的 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」,点击「信任」后刷新即可。


Related MCP server: boss-zhipin-mcp

工具清单

工具名

功能

档位

说明

health

连通性 + 权益回显

免费

验证 key 是否有效、当前套餐

search_articles

求职干货检索

免费

关键词检索 44+ 篇方法论文章,零 AI 成本

holland_assessment

霍兰德职业测评

免费

60 题兴趣测评,返回三字母代码 + 解读报告

interview_questions_bank

笔试真题库

免费

分类树 / 抽题(不含答案)/ 判分解析

resume_diagnose

快速简历诊断

免费试用 1 次

综合评分 + 五维打分 + 亮点/问题/建议

resume_rewrite

简历改写

会员

STAR 重构经历、优化措辞

resume_tailor

岗位定制

会员(35 积分)

按 JD 定制,突出匹配关键词

interview_coach

单面陪练点评

会员

答题打分 + 改进点 + 参考回答

interview_prediction

面试押题

会员

按公司/岗位预测面试题

ocr_exam_search

OCR 拍照搜题

Pro

上传题目图片,识别题干并返回答案与解析(月度额度)

会员级能力(简历改写、岗位定制、单面陪练、面试押题等)通过服务端会员门禁控制;被拒时 AI 会展示开通链接(upgradeUrl)。OCR 拍照搜题为 Pro 专属。


本地开发

npm install
npm run build      # 编译 TypeScript 到 dist/
npm run dev        # 直接跑源码(tsx)

运行(需先设置环境变量):

INTERVIEWSAGE_API_KEY=mmx_xxx npx -y @interviewsage/mcp

环境变量

变量

必填

默认值

说明

INTERVIEWSAGE_API_KEY

面面星网页端生成的 API key(mmx_ 前缀)

INTERVIEWSAGE_BASE_URL

https://www.interviewsage.cn

服务端地址,一般无需改


FAQ

Q:为什么我的 key 用不了? A:到网页端「API 密钥」页确认 key 未撤销、未过期、未禁用;重新生成一把试试。

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:本 relay 完全免费开源(MIT)。面面星会员是另一回事,一个身份网页端与 MCP 端通用。

Q:key 会过期吗? A:默认长期有效,可在网页端随时撤销。建议定期轮换。


License

MIT。本仓库为薄 relay,不含面面星任何核心业务逻辑。

Available Tools

10 tools
healthA

检查面面星 MCP 连接与当前 API key 的会员权益状态(免费)。用于验证 key 是否有效、当前套餐档位。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.4/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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 题答案后返回三字母职业代码与完整解读报告。

ParametersJSON Schema
NameRequiredDescriptionDefault
answersNo60 题答案数组;留空则只下发题目

TDQS

A4.4/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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

单面陪练点评(会员)。对某道面试题的回答打分,并给出亮点、改进点与参考回答。需会员。

ParametersJSON Schema
NameRequiredDescriptionDefault
questionYes面试题
resumeTextNo简历全文(可选,用于个性化点评)
userAnswerYes你的回答

TDQS

A4.2/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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

面试押题(会员)。根据公司与岗位预测可能被问到的面试题,附带参考答案、答题思路与追问。需会员。

ParametersJSON Schema
NameRequiredDescriptionDefault
countNo题目数量,默认 8
jobTitleYes岗位名
resumeTextNo简历全文(可选,用于个性化出题)
companyNameYes公司名

TDQS

A4/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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 提交答案并返回正误、正确答案与解析。

ParametersJSON Schema
NameRequiredDescriptionDefault
countNo抽题数量,默认 10
actionYessections=查看分类树 / questions=抽题(不含答案)/ check=提交答案判分
companyNo企业真题来源,如 kimberly / chinamobile
sectionNo行测大类,如 verbal / quantitative / judgment / data_analysis / professional
difficultyNo难度 1-5
questionIdNocheck 时必填:题目 id
subsectionNo子题型 key
userAnswerNocheck 时必填:所选选项 key(如 A/B/C/D)

TDQS

A4.2/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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.

resume_diagnoseA

快速简历诊断(免费试用 1 次)。输入简历全文,返回综合评分、五维打分、亮点、问题与可执行改进建议。首次免费,再次使用需开通会员。

ParametersJSON Schema
NameRequiredDescriptionDefault
resumeTextYes简历全文文本(纯文本)

TDQS

A4.1/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness5/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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 法则重构经历、优化措辞,返回改写后的完整简历与改动说明。需会员。

ParametersJSON Schema
NameRequiredDescriptionDefault
resumeTextYes简历全文文本(纯文本)

TDQS

A3.8/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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 定制简历,突出与之匹配的关键词与经历。需会员。

ParametersJSON Schema
NameRequiredDescriptionDefault
jdTextYes目标岗位 JD 全文(纯文本)
resumeTextYes简历全文文本(纯文本)

TDQS

A3.5/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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)。输入关键词返回匹配的文章标题、摘要与阅读链接,覆盖简历、面试、笔试、职业规划等求职方法论。

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo返回条数,默认 10
queryYes搜索关键词,例如「简历 自我介绍」

TDQS

A3.8/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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. Dates show when Glama detected each change.

  1. 10 tool updatesv0.1.0
    • First observedhealth
    • First observedholland_assessment
    • First observedinterview_coach
    • First observedinterview_prediction
    • First observedinterview_questions_bank
    • First observedocr_exam_search
    • First observedresume_diagnose
    • First observedresume_rewrite
    • First observedresume_tailor
    • First observedsearch_articles

TDQS

A3.9/5.0
Disambiguation4/5

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.

Naming Consistency2/5

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).

Tool Count5/5

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.

Completeness5/5

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

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gowing111/interviewsage-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server