好啦体检 MCP
企业团检分档方案、门店查询、体检 FAQ 与企业咨询,覆盖 241 城。
사용해야 할까요
품질 및 안전성
발견 사항 (12)
- HIGH
- LOWvendor_brands에서
- LOWtemplate_stats에서
- LOWcorp_inquiry에서
- LOWcorp_contact에서
- LOWplan_recommend에서
- LOWwelfare_detail에서
- LOWorder_detail에서
- LOWreservation_book에서
- LOWreservation_modify에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"haola-pe": {
"url": "https://ai.ihaola.com.cn/api/mcp/haola-pe"
}
}
}원격 엔드포인트
https://ai.ihaola.com.cn/api/mcp/haola-pestreamable-http할 수 있는 일
도구 목록
도구 (26)
🟢vendor_list(city, province, district, hospitalCode, longitude, ...)
查具体门店地址。仅在用户已选定城市+品牌、需查看门店位置或预约时使用。必须传 city/vendorids 等筛选条件,缺条件直接拒绝。不确定有哪些品牌和覆盖城市时先用 vendor.brands。本体: vendor → Action: list
입력 스키마
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"province": {
"type": "string"
},
"district": {
"type": "string"
},
"hospitalCode": {
"type": "string"
},
"longitude": {
"type": "number"
},
"latitude": {
"type": "number"
},
"radius": {
"type": "number"
},
"vendorids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪vendor_brands
查各体检品牌覆盖的城市(品牌聚合摘要,不返回具体门店)。本体: vendor → Action: brands
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢order_list(limit, page, filter)
查订单。查询 userOrders 集合。调用方归属甲方由服务端身份解析,filter 中无需传 partnerid。支持 $gte/$lte 日期范围、$in/$or 多值匹配。本体: order → Action: list 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"type": "number"
},
"page": {
"type": "number"
},
"filter": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢welfare_list(ID, partnerid, userid, serviceid, rootid, ...)
查用户体检件。查询 userWelfare 集合。传 {customerMobile: "138xxx"} 或 {name: "张三"} 查对应用户的体检件。已知 userid 可直接传 {userid: "xxx"}。本体: welfare → Action: list 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"ID": {
"type": "string"
},
"partnerid": {
"type": "string"
},
"userid": {
"type": "string"
},
"serviceid": {
"type": "string"
},
"rootid": {
"type": "string"
},
"mobile": {
"type": "string"
},
"name": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪template_stats(partnerid)
团单模板统计。查询 welfareTemplate 集合,返回发放/激活/预约/到检/报告计数。调用方归属甲方由服务端身份解析。本体: template → Action: stats 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"partnerid": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪corp_inquiry(company, contact, phone, employees, city, ...)
提交企业商务咨询。企业客户有任何问题(合作咨询、产品了解、报价请求、投诉建议)均可提交,销售 24h 内联系。本体: corp → Action: inquiry
입력 스키마
{
"type": "object",
"properties": {
"company": {
"type": "string"
},
"contact": {
"type": "string"
},
"phone": {
"type": "string"
},
"employees": {
"type": "number"
},
"city": {
"type": "string"
},
"budget": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"company",
"contact",
"phone"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪corp_contact
查询好啦商务对接人(团检/商务合作):返回对接人姓名、电话、邮箱、二维码图片 URL。用户报价后需要人工商务对接时调用。本体: corp → Action: contact
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪plan_quotation(quotes, partnerId)
企业团检报价:quotes 为对象数组,每档一个方案。每项 = { tier(档名,仅标识该档、不参与报价,返回时回填), budget(人均预算元,必填), healthConcerns(该档健康诉求,必填), populations?(人群数组 man/lady/girl,默认三人,该档) }。可选 partnerId(甲方 UUID),透传给 /plan/quotation 按伙伴定价。返回 data.list(每档 { tier, budget, planList, combinedPrice, discount }),其中 planList 为**按人群的数组**(每项 { population, price, items, planId }),逐档按人群拆分并发取值;planId 是该档该人群的方案标识,体检预约时传给 reservation.book,不要自己拼项目;discount 为该伙伴折数(如 5 表示 5 折,无则 null)。调用前先用 knowledge_get({uri:"objects/checkup-proposal"}) 加载《企业团检方案顾问》引导词作为 agent 的 system prompt;对客话术与输出模板必须遵循该引导词,严禁编造项目/费用。字段说明见 knowledge://objects/checkup-proposal。本体: plan → Action: quotation
입력 스키마
{
"type": "object",
"properties": {
"quotes": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"partnerId": {
"type": "string"
}
},
"required": [
"quotes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪plan_recommend(gender, marital, age, budget, mainComplaint, ...)
个人体检推荐:按调用方身份读用户名下体检件与模板,结合性别、婚姻状况、预算、健康诉求推荐体检项目,返回 data.selected_items(每项带 constraintId)与 planId。planId 直接传给 reservation.book 预约,不要自己拼项目。长耗时,建议每阶段调用 progress.report。本体: plan → Action: recommend 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"gender": {
"type": "string"
},
"marital": {
"type": "string"
},
"age": {
"type": "number"
},
"budget": {
"type": "number"
},
"mainComplaint": {
"type": "string"
},
"reportHistory": {
"type": "string"
},
"userContext": {
"type": "string"
},
"welfareid": {
"type": "string"
},
"modification": {
"type": "string"
},
"previousPackage": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"gender"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢faq(query)
体检 FAQ。不传 query 则列出所有问题。query 必须是短关键词(2-4字,如"报告"、"预约"、"空腹"),不要传完整问句。
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢knowledge_get(uri)
按需查询领域知识。外部可用 URI: enums(状态码) / objects/checkup-proposal(企业团检方案顾问引导词)。查 action 参数用 help()。团检报价场景先用 knowledge_get({uri:"objects/checkup-proposal"}) 加载《企业团检方案顾问》引导词作为外部 MCP agent 的 system prompt,再调 plan_quotation;报价话术与输出模板必须遵循该引导词
입력 스키마
{
"type": "object",
"properties": {
"uri": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪help(ontology, sub_action)
三级帮助系统。无参列出本体;传 ontology 列出该本体下工具;传 ontology 和 sub_action 查看参数,sub_action 用完整名称,如 vendor.list、plan.quotation。
입력 스키마
{
"type": "object",
"properties": {
"ontology": {
"type": "string"
},
"sub_action": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪welfare_detail(welfareid, vendorid)
查询指定福利的详细内容,包括检查项目列表、规则说明、适用机构等。本体: welfare → Action: detail 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"welfareid": {
"type": "string"
},
"vendorid": {
"type": "string"
}
},
"required": [
"welfareid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪cautions(checkPackage, vendorid, serviceid)
根据体检项目查询注意事项(饮食、用药、禁忌等)。需调用方用户标识(external_user_id 自动注入),partnerid 由服务端按用户标识解析,禁止客户端传。传 checkPackage 查套餐注意事项(必带 vendorid);传 serviceid 仅允许查本人订单。本体: knowledge → Action: cautions 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"checkPackage": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"vendorid": {
"type": "string"
},
"serviceid": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪order_detail(serviceid)
查询单个订单完整详情,包括预约信息、医院信息、套餐项目、支付状态。本体: order → Action: detail 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"serviceid": {
"type": "string"
}
},
"required": [
"serviceid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contact_list(userid)
列出当前用户的就诊人列表。本体: contact → Action: list 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"userid": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contact_get(contactid, userid)
查询指定就诊人的完整信息(含脱敏证件号)。本体: contact → Action: get 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"contactid": {
"type": "string"
},
"userid": {
"type": "string"
}
},
"required": [
"contactid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡contact_create(customerName, customerMobile, customerID, gender, birthday, ...)
新增就诊人信息。本体: contact → Action: create 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"customerName": {
"type": "string"
},
"customerMobile": {
"type": "string"
},
"customerID": {
"type": "string"
},
"gender": {
"type": "string"
},
"birthday": {
"type": "string"
},
"marriage": {
"type": "string"
}
},
"required": [
"customerName",
"customerMobile",
"customerID"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡contact_update(contactid, customerName, customerMobile, customerID)
更新就诊人信息(姓名、手机号等)。本体: contact → Action: update 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"contactid": {
"type": "string"
},
"customerName": {
"type": "string"
},
"customerMobile": {
"type": "string"
},
"customerID": {
"type": "string"
}
},
"required": [
"contactid"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪reservation_book(planId, hospitalCode, vendorid, appointmentDate, timespan, ...)
体检预约:按 planId 取出项目,交给伙伴接口下单。体检项目只来自 planId,客户端不能提交项目。返回 serviceid 作为预约号、orderEntryUrl 作为订单列表页链接:用户在 H5 用手机号登录后可看到自己的订单,并可支付、改期/取消、查看检前注意事项、查看体检报告;渠道需要用户支付时,一并返回短链 payUrl 与支付提示。本体: reservation → Action: book 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"planId": {
"type": "string"
},
"hospitalCode": {
"type": "string"
},
"vendorid": {
"type": "string"
},
"appointmentDate": {
"type": "string"
},
"timespan": {
"type": "string"
},
"customerName": {
"type": "string"
},
"customerID": {
"type": "string"
},
"customerMobile": {
"type": "string"
},
"payType": {
"type": "string"
}
},
"required": [
"planId",
"hospitalCode",
"vendorid",
"appointmentDate",
"customerName",
"customerID"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reservation_cancel(reservationId)
取消预约:按预约号取消,预约号取自 reservation.book 返回的 serviceid。本体: reservation → Action: cancel 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"reservationId": {
"type": "string"
}
},
"required": [
"reservationId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡reservation_modify(reservationId, appointmentDate)
更改预约日期:按预约号改期。本体: reservation → Action: modify 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"reservationId": {
"type": "string"
},
"appointmentDate": {
"type": "string"
}
},
"required": [
"reservationId",
"appointmentDate"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢card_list(cardId, limit)
根据卡号查卡密及兑换使用情况。welfareId 为空=未兑换,非空时串联福利和订单。本体: card → Action: list 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"cardId": {
"type": "string"
},
"limit": {
"type": "number"
}
},
"required": [
"cardId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢template_list(partnerid)
查询团单模板列表。按 partnerid 过滤,返回模板摘要(不含套餐明细 rules.items)。外部调用由服务端身份解析归属甲方。本体: template → Action: list 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"partnerid": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪template_detail(id)
查询团单模板详情,返回完整模板文档含 users 字段(每个 user 含 welfareId/isConsumed)。本体: template → Action: detail 鉴权:需要用户登录令牌。未登录调用会返回 401,客户端应完成 OAuth 授权后重试。
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪progress_report(text, stage, percent)
长耗时任务进度上报。agent 每完成一个阶段调用一次,text 为给用户看的可读进度,如「报告解析中,预计 10 秒」。不落地业务数据,仅用于向用户展示过程。
입력 스키마
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"stage": {
"type": "string"
},
"percent": {
"type": "number"
}
},
"required": [
"text"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거