shouhou-kb
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
shouhou-kb
家庭宽带 / 路由器 售后知识库:BM25 检索 + 回答生成 + MCP 服务。
装完就能用:检索不需要任何 API key,只有“让模型生成回答”需要 DEEPSEEK_API_KEY。
pip install .
shouhou-mcp # MCP 服务(stdio)
shouhou-web # 网页问答用 MCP(给任意 agent 用)
{
"mcpServers": {
"shouhou-kb": {
"command": "shouhou-mcp",
"env": { "DEEPSEEK_API_KEY": "sk-你的key" }
}
}
}三个工具:
工具 | 作用 | 需要 key |
| 检索知识库切片,返回文件/标题/相关度 | ❌ |
| 取一篇全文( | ❌ |
| 检索 + 生成,带来源 | ✅ |
strict=True 时只依据知识库回答,资料没覆盖就明确说“知识库未覆盖”,不拿通用知识编。
Related MCP server: Zendesk Help Center MCP Server
用网页
shouhou-web # http://127.0.0.1:8899
shouhou-web --port 9000接口:
方法 | 路径 | 说明 |
POST |
|
|
POST |
|
|
用 Python
from shouhou_kb import retrieve, answer
hits = retrieve("5G 信号只有一格", top_k=3) # 不需要 key
out = answer("5G 信号只有一格", strict=True) # 需要 key
print(out["answer"], out["citations"])知识库内容
8 篇 / 70 个切片:
篇 | 主题 |
01 | 光猫与宽带接入(指示灯、光衰、桥接) |
02 | 拨号错误码与上网方式(691 / 678 / 651 / PPPoE) |
03 | WiFi 频段与干扰(2.4G/5G、信道、DFS、双频合一) |
04 | 路由器后台与常用设置(登录、改密码、端口映射、安全加固) |
05 | 组网与漫游(Mesh、AC+AP、有线回程、伪漫游) |
06 | 网速诊断与测速(百兆/千兆瓶颈、测速达标率) |
07 | 选购与硬件接口(2.5G 网口、六类线、光猫选型) |
08 | 故障速查表(按现象 / 按设备两套索引) |
循环检测(内置)
层 | 触发 | 处理 |
输出循环 | 同一句重复 ≥3 次或 8 字片段重复率 ≥0.32 | 换说法重试一次,仍重复则去重截断 |
工具循环 | 同参数连续调同一工具 3 次 | 返回上次结果并提示换关键词 |
会话循环 | 同一问题问第 2 次 | 复用上次答案,标记 |
阈值可用环境变量调:SHOUHOU_MAX_TOOL_REPEAT / SHOUHOU_MAX_SAME_QUESTION / SHOUHOU_OUTPUT_LOOP_RATIO。
为什么默认 BM25,不用向量
同一套 50 题、同一个知识库、同一判定口径下的配对实验:
BM25 | 向量混合 | |
平均要点分 | 0.656 | 0.630 |
配对差 95% CI | — | [−0.068, +0.016](跨 0) |
没有可测差异,而向量需要云端 embedding 服务——多一个外部依赖、多一个失效点。
所以默认 BM25(shouhou_kb/retrieval.py 里是自包含实现,零依赖)。
要换成向量检索,替换 KB.search() 即可,接口不变。
测试
python -m pytest tests -q # 7 个用例许可
MIT。知识库为整理的通用售后经验,不含厂商机密;具体产品参数请以官方文档为准。 回答由模型生成,仅供参考。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search your knowledge bases from any AI assistant using hybrid RAG.
Web knowledge fetching tools for your agent.
Maintained, agent-readable knowledge bases with calibrated search and provenance. Pro key adds XL.
Team knowledge base for snippets, API calls and docs. Agents search and file items; humans review.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search and retrieve information from your knowledge base using RAG (Retrieval-Augmented Generation) with hybrid search, document indexing, and ChromaDB vector storage.35 npmMIT
- AlicenseAqualityDmaintenanceEnables searching and retrieving Zendesk Help Center articles through natural language, supporting article search and detailed article lookup by ID.26MIT
- AlicenseAqualityDmaintenanceEnables AI agents to browse, search, and fetch documentation from any public Zendesk Help Center via a read-only API.9MIT
- FlicenseNot gradedqualityDmaintenanceEnables searching a knowledge base and asking grounded questions with hybrid retrieval, reranking, and cited answers.-