问家家庭维修诊断 MCP Server
mcp-name: io.github.gmcho2009-cloud/wenjia-home-fix
中文家庭维修自助诊断引擎的 MCP 服务端。40 品类 / 200 症状 / 800 原因 / 3,687 修复步骤。 纯 Python 标准库，零第三方依赖，只读，无鉴权。数据 CC BY 4.0。
装法与运行
uvx wenjia-home-fix-mcp # 默认 stdio 传输，给 MCP 客户端
pip install wenjia-home-fix-mcp # 等价，装完命令同名
python -m wenjia_home_fix.server --stdio # 等价写法
wenjia-home-fix-mcp --http # 需要 HTTP 服务时显式加参数
MCP 客户端配置（Claude / Cursor / VS Code 通用）：
{"mcpServers": {"wenjia-home-fix": {"command": "uvx", "args": ["wenjia-home-fix-mcp"]}}}
工具
入口（不用猜 id）：
| 工具 | 用法 |
|---|---|
find_symptom |
用户原话直接丢进来（「空调不凉」「热水器打不着火」「马桶堵了」），返回最可能的 symptom_id + 候选 |
get_category |
给品类 id 或中文名，返回该品类全部症状清单 |
解决方案：
| 工具 | 返回 |
|---|---|
fix_plan |
分步方案：原因按动手难度从低到高排，每步动作 + 配件 + 安全提示 + 停手点，约 1,300–1,600 字符 |
diagnose |
按概率排序的原因 + 追问选项 |
get_symptom |
单个症状完整诊断树，约 2,350 字符 |
原子事实（省 token，给 agent）：
| 工具 | 返回 |
|---|---|
prob_distribution |
原因先验概率分布（合计 100）+ 能否 DIY，约 530 字符 |
price_band |
上门价格区间（元）+ 配件价，约 410 字符 |
stop_check |
风险等级（gas / electric / height）+ 必须停手的理由，约 420 字符 |
同一症状下，三个原子工具比 get_symptom 省 77–83% 上下文。
category_id / symptom_id 都认中文名和常见口语，认不出来时错误信息里直接给可用 id。
我们刻意不卖的东西
分步修复文本——前沿模型自己写得已经很细。它造不出来的是先验概率、地域价格、涉险停手判断，这三个工具只为这三件事存在。
数据口径（诚实说明）
prob_prior是文献与经验先验，不是工单统计，只能当排序信号，不能当精确频率。- 价格是 2026 年中国市场区间（CNY），未建模地域差异。
- 覆盖城市住宅场景，农村自建房不在范围内。
- 每个症状带
see_pro字段（何时停手找持证技师），转发时不要删。
数据来自问家家庭维修诊断树（40 品类 212 症状，持续更新）。引用请保留出处与版本号。
1 maintainer
Metadata
1 maintainer
Release files for wenjia-home-fix-mcp 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wenjia_home_fix_mcp-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for wenjia_home_fix_mcp-0.2.3-py3-none-any.whl |
Release files / wenjia_home_fix_mcp-0.2.3-py3-none-any.whl
| Download URL | wenjia_home_fix_mcp-0.2.3-py3-none-any.whl |
|---|---|
| Size | 500.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4e16fda3cea5ebe5412ae2beb7e1536bfbb1841e4bd383c042f876785572f2aa
|
|
BLAKE2b-256 checksum How to use checksums |
9e038dd6ee81e1f7ef14bc3d1bc9828cf7bf2e4c3505c09445e58e5acdaeb209
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for wenjia-home-fix-mcp 0.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
