← 返回目录

ByteAsk Embedded MCP

社区

面向嵌入式与固件编码代理的带页引用的文档检索服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 199 / 438
Stars: ★ 25 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: 远程托管（无需本地环境） · Python 3.10+
凭据: 无需凭据
许可证: MIT
最近提交: 4 个月前
工具数: 3

54FMRS · D

ByteAsk Embedded MCP 提供一种独特且严谨的检索方式，专注于嵌入式开发中的精确事实，输出带引用，适合对保真度要求高的代理。但需注意托管服务与自托管的差异、认证的局限性。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 8/20

可靠性

10/20

安全与权限

8/20

维护活跃度

9/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README描述了工具集与布局、离线pytest测试，但未提供可验证的CI工作流或已提交的测试内容，静态审查无法确认握手与工具行为一致；核心检索引擎不在仓库内（SampleBackend仅为演示），关键路径不可静态复现。扣分：缺执行证据、核心实现封闭。
安全与权限 8/20: 无恶意行为迹象，且明确披露bearer认证为stub、无token时未认证、查询/请求被JSONL记录。但承认认证为共享secret stub、HTTP模式需手动加固，request_document服务端记录请求存在轻量数据外发但已披露。扣分：默认HTTP可无认证、认证机制薄弱。
维护活跃度 9/20: MIT许可证明确，版本1.0.1，1个开放issue，非归档，鼓励PR。但stars仅23，无发布渠道、安全响应通道或依赖更新策略的证据。扣分：治理与响应通道信息缺失。
文档质量 14/20: README详尽：安装、双传输、工具表、配置表、示例输出、自述限制（stub认证、演示后端）、外链文档站。静态审查无CLI参数详细文档之外的明显矛盾。扣分：无独立故障排查节，文档站点内容不可静态验证。
安装易用性 13/20: 本地路径两步（uv sync + run）加Claude Code/Cursor/Codex示例配置齐全，远程托管端点零安装可用，环境变量表清晰。但实际执行证据缺失，静态上限内给分。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要精确、可引用嵌入式文档事实的开发场景
希望快速集成并可扩展检索后端的用户

不适合谁

需要自然语言总结或非逐字答案的应用
对不真实内容敏感、需依赖服务器完整语料的场景
需要保证权威来源的身份验证的用户

所需权限

可接收查询并返回检索结果
可请求文档添加（仅记录）
本地网络下的 HTTP 服务器和认证

风险与副作用

完整的检索能力仅通过托管服务提供；自托管后端为示例，可能无法覆盖所有文档。
HTTP 传输的 bearer 认证为示例桩，生产环境需替换为成熟认证。
存在 DNS rebinding 保护，但公开部署时仍需额外加固。
工具返回的摘录可能来自非权威或过时文档，用户需自行核验。

安装接入

准备工作

运行环境：远程托管（无需本地环境） · Python 3.10+

MCP_HTTP_AUTH_TOKEN 可选密钥可选，HTTP 传输的 Bearer 令牌（自设共享密钥，仅为占位实现），留空则不鉴权。

其他可选配置项（7 个）

BYTEASK_BACKEND 可选可选，指定自定义检索后端，格式为 module:callable（返回 SearchBackend）；留空使用内置 SampleBackend。

BYTEASK_LOGS 可选可选，查询/请求 JSONL 日志的写入目录，默认 logs。

MCP_TRANSPORT 可选可选，传输方式：stdio（本地代理）或 http，默认 stdio。

MCP_HTTP_HOST 可选可选，HTTP 模式绑定的主机地址，默认 127.0.0.1。

MCP_HTTP_PORT 可选可选，HTTP 模式绑定的端口，默认 8000。

MCP_ALLOWED_HOSTS 可选可选，HTTP 传输 DNS 重绑定防护允许的 Host 头列表，逗号分隔；* 表示禁用防护。

LOG_LEVEL 可选可选，stderr 日志级别，默认 INFO。

确保已安装 Python 3.10 及以上和 uv。
克隆仓库并运行 uv sync。
运行 uv run byteask-embedded-mcp 以 stdio 模式启动服务器。
或直接连接托管端点 https://mcp.byteask.ai/mcp（Streamable HTTP）。

claude_desktop_config.json

{
  "mcpServers": {
    "byteask-embedded-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.byteask.ai/mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "byteask-embedded-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.byteask.ai/mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add byteask-embedded-docs -- npx -y mcp-remote https://mcp.byteask.ai/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

客户端连接 https://mcp.byteask.ai/mcp 后，工具列表中应出现 search_docs、get_context 和 request_document；用 search_docs 查询一个已知协议事实（如 Modbus 功能码 16），返回带页码引用的原文片段即说明安装成功。

常见排障

确保 Python 版本符合要求（≥3.10）并安装 uv。
运行 `uv run pytest` 检查基本功能。
检查环境变量配置，如 `BYTEASK_BACKEND`、`MCP_TRANSPORT`、`MCP_HTTP_AUTH_TOKEN` 等。
若用本地后端，确认日志文件位置（`BYTEASK_LOGS`）以排查错误。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

Modbus 写多个寄存器用哪个功能码？
查一下 ETH_DMATDLAR 这个寄存器的准确名称和定义，给出页码引用
SunSpec 协议中这个点位的确切含义是什么？从文档原文引用
帮我申请收录某份缺失的数据手册文档

工具能力 3

search_docs 只读

在文档语料库中搜索查询，返回带页码引用的排序结果。

get_context 只读

根据结果 ID 展开命中的完整源章节。

request_document 写入

请求添加缺失的文档（服务器端记录）。

使用场景

需要查证寄存器偏移、Modbus 功能码、SCPI 命令等精确事实的固件开发。

希望获得带页码引用的逐字摘录而非一般性答案的编码代理。

在选择可自托管检索服务之前，试验零配置示例后端的场景。

支持客户端

Claude Desktop

Codex

Cursor

依据项目文档列出，未经本站实测。

详细介绍

ByteAsk Embedded MCP 是一个开源 MCP 服务器，为编写固件、驱动、协议代码的 AI 编程代理提供来源可溯、带页码引用的证据检索。它只返回逐字摘录并附带章节和页码引用，绝不生成自拟答案；在无相关内容时返回“无匹配”而非编造。该服务器支持 stdio 和 Streamable HTTP 两种传输，并提供一个可插拔的检索后端接口；本仓库自带内存示例后端以便开箱即用，完整语料和检索引擎托管于 https://mcp.byteask.ai/mcp。