HT32 Wiki MCP Server

为 AI Agent 提供 HT32 MCU 选型与知识检索能力的 MCP Server。

功能

共 14 个工具 + 3 个资源：

• search_knowledge(query, limit, include_datasheets) — 知识页混合检索（词法 + 向量 + 重排），片段按查询词锚定并附章节面包屑
• search_datasheets(query, limit) — Datasheet / User Manual 章节级检索
• get_wiki_page(path, section) — 按路径直读 wiki 页面全文或指定小节（search 命中后的下一跳）
• get_chip_info(model) / get_model(model) — 芯片系列详情 / 型号到文档映射
• get_peripheral_info(name) — 获取外设详情
• compare_chips(models) — 对比多个芯片型号
• list_chips() / list_peripherals() / list_datasheets() — 列出芯片 / 外设 / 原档清单
• get_datasheet(series, max_length) — 获取 Datasheet / User Manual 全文
• get_wiki_version() — 获取知识库与 MCP 版本信息
• report_skill_version(version) — 会话开始上报本机 ht32-skills 版本，用于用量日志打标
• submit_feedback(question, issue_type, ...) — 提交纠正反馈，帮助改进知识库

资源：wiki://overview、wiki://chips/{model}、wiki://peripherals/{name}。

使用方法

环境变量

stdio 模式（本地调试）

uvx ht32-wiki-mcp

Streamable HTTP 模式

MCP_TRANSPORT=streamable-http uvx ht32-wiki-mcp

反馈机制（submit_feedback）

用户 Agent 在回答不准确、用户指出错误、或知识库信息缺失时，可调用 submit_feedback 提交纠正反馈。反馈以 JSON Lines 格式写入 <FEEDBACK_ROOT>/wiki/，按日期分文件（feedback_YYYY-MM-DD.jsonl）；每次工具调用另由服务端写入 usage_YYYY-MM-DD.jsonl。

示例记录：

{"timestamp":"2026-08-10T10:00:00+00:00","question":"F52231 GPTM 最高频率？","issue_type":"wrong_spec","answer":"48MHz","correction":"72MHz，参考 UserManual 时钟章节","details":""}

System Prompt 提示词模板

部署 Open WebUI 或其他 MCP 客户端时，建议在系统提示词中加入以下内容，提升反馈触发率：

你是一个 HT32 MCU 技术专家助手，基于 HT32 Wiki 知识库回答问题。

工具使用规范：
1. 回答涉及芯片选型、外设规格、参数对比时，优先调用 search_knowledge / get_chip_info / get_peripheral_info / compare_chips 检索知识库，不要凭记忆回答。
2. 当出现以下情况时，必须调用 submit_feedback 工具提交反馈：
   - 用户明确指出你的回答有误（如"不对"、"错了"、"应该是..."）
   - 你从知识库查到的数据与用户描述矛盾
   - 知识库查不到相关信息，你只能给出推测性回答
   - 用户提供了比你回答更准确的型号/规格/参数信息
3. submit_feedback 的 question 参数尽量完整抄录用户原始问题；correction 填写你认为正确的信息或用户指出的正确内容。
4. 不确定的信息要如实说明"知识库未覆盖"，不要编造参数。

开发

uv sync --frozen
uv run python -m ht32_wiki_mcp