ByteAsk Embedded Docs MCP server
AI 코딩 에이전트가 임베디드 및 펌웨어 참조 문서에서 레지스터, 프로토콜, 표준에 관한 정확한 문구와 페이지 인용 스니펫을 검색할 수 있도록 지원합니다.
다른 이름 ByteAsk/ByteAsk-Embedded-MCP, byteask-embedded-mcp
- 스타
- 26
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 6월 20일
- 라이선스
- MIT
ByteAsk Embedded Docs MCP란?
AI 코딩 에이전트가 임베디드 및 펌웨어 참조 문서에서 레지스터, 프로토콜, 표준에 관한 정확한 문구와 페이지 인용 스니펫을 검색할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
ByteAsk Embedded Docs MCP server 정보
embedded-docs는 펌웨어 및 드라이버 개발자가 AI 코딩 에이전트에게 페이지 인용이 포함된 정확한 기술 문서를 제공할 수 있게 합니다. 이를 통해 Claude Code, Cursor, Codex와 같은 에이전트가 환각 현상의 위험 없이 정확한 레지스터 오프셋, 프로토콜 기능 코드, 표준 임계값을 검색할 수 있습니다. 서버는 그럴듯하지만 틀린 값을 생성하는 대신, 참조 매뉴얼에서 직접 스니펫을 가져오거나 정보가 없는 경우 일치하는 결과가 없음을 반환합니다.
개발자는 이를 streamable HTTP를 통해 원격 서비스로 사용하거나 stdio 전송 방식을 사용하여 로컬에서 실행할 수 있습니다. 호스팅된 엔드포인트는 전체 라이선스 코퍼스에 대한 액세스를 제공하며, 로컬 버전은 API 키 없이 즉시 테스트할 수 있도록 샘플 백엔드를 포함합니다. 사용자는 제공된 인터페이스에 커스텀 백엔드를 연결하여 자체 검색 엔진을 구현할 수도 있습니다. 시스템에는 코퍼스를 검색하고, 특정 검색 결과를 전체 소스 섹션으로 확장하며, 새로운 문서를 요청하는 도구가 포함되어 있습니다.
활용 사례
- 1레지스터 값 검증AI 에이전트가 특정 레지스터 오프셋이나 비트 정의를 검색하여 펌웨어 코드가 정확한지 확인할 수 있습니다.
- 2통신 프로토콜 구현개발자가 하드웨어 상호작용에 필요한 정확한 Modbus 기능 코드나 SCPI 명령어를 찾는 데 사용할 수 있습니다.
- 3AI 환각 방지서버는 코딩 에이전트가 기술 사양을 임의로 만들어내는 대신 인용된 근거에 기반하도록 보장합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ByteAsk Embedded Docs MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 ByteAsk Embedded Docs MCP 설치
$ claude mcp add --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcpCursor에 ByteAsk Embedded Docs MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"byteask-embedded-mcp": {
"url": "https://mcp.byteask.ai/mcp"
}
}
}VS Code에 ByteAsk Embedded Docs MCP 설치
.vscode/mcp.json
{
"servers": {
"byteask-embedded-mcp": {
"type": "http",
"url": "https://mcp.byteask.ai/mcp"
}
}
}VS Code CLI에 ByteAsk Embedded Docs MCP 설치
$ code --add-mcp '{"name":"byteask-embedded-mcp","type":"http","url":"https://mcp.byteask.ai/mcp"}'Codex에 ByteAsk Embedded Docs MCP 설치
$ codex mcp add byteask-embedded-mcp --url https://mcp.byteask.ai/mcpCodex config.toml에 ByteAsk Embedded Docs MCP 설치
~/.codex/config.toml
[mcp_servers.byteask-embedded-mcp] url = "https://mcp.byteask.ai/mcp"
Gemini CLI에 ByteAsk Embedded Docs MCP 설치
$ gemini mcp add -s user --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcpGemini settings.json에 ByteAsk Embedded Docs MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"byteask-embedded-mcp": {
"url": "https://mcp.byteask.ai/mcp",
"type": "http"
}
}
}구성
BYTEASK_BACKENDMCP_TRANSPORT
| 이름 | 설명 | 유형 |
|---|---|---|
| BYTEASK_BACKEND | — | |
| MCP_TRANSPORT | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능byteask/byteask-embedded-mcp is public and reachablegithub.com/byteask/byteask-embedded-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-06-20github.com/byteask/byteask-embedded-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 1055 ms통과
README
GitHub에서 보기ByteAsk Embedded MCP
Page-cited answers from embedded & firmware reference docs — for coding agents that can't afford to guess a register value.
Official MCP Registry Namespace: ai.byteask/embedded-docs · Remote MCP Endpoint: https://mcp.byteask.ai/mcp
Quickstart · Tools · Connect a client · Configuration · Hosted server · Contributing
ByteAsk Embedded MCP is the open-source server behind ByteAsk Embedded Docs: a source-grounded, page-cited evidence-retrieval MCP server for coding agents (Claude Code, Codex, Cursor) that write firmware / driver / protocol code and need exact facts — SunSpec points, register offsets, Modbus function codes, trip thresholds, SCPI commands, API symbols.
It returns verbatim snippets with page citations — never an authored answer — and when nothing is relevant enough it says no match rather than fabricate. Every document is treated equally: no authority layer, no filters.
[!NOTE] What's in this repo: the MCP server — tools, transports (stdio + Streamable HTTP), bearer auth, DNS-rebinding protection, result rendering — plus a small, pluggable retrieval interface.
What's not in this repo: the retrieval engine and the document corpus. How documents are parsed, chunked, embedded, and ranked, and the licensed source material itself, sit behind the
SearchBackendseam and power the hosted endpoint athttps://mcp.byteask.ai/mcp. This repo ships an in-memorySampleBackend(a few illustrative, public-knowledge records) so the server runs out of the box.
Why
- Cited, or nothing. Every hit is verbatim source text with a section + page citation. On a miss it returns an honest "no confident match" — it never invents a register value.
- Built for coding agents. The tool descriptions and triggers are tuned so agents
call
search_docsreflexively the moment they see a hex literal, a Modbus code, an IEEE clause, a SCPI verb, or an MCU part number — before answering from memory. - Two transports, one server.
stdiofor local agents, Streamable HTTP for hosted. - Bring your own retrieval. The search engine is a two-method interface — swap in
anything behind
BYTEASK_BACKENDwithout touching the server. - Zero-setup demo. The bundled
SampleBackendruns immediately. No API keys.
Quickstart
Requires Python ≥ 3.10 and uv.
uv sync
uv run byteask-embedded-mcp # run as an MCP server (stdio)
That's it — the bundled SampleBackend serves a couple of illustrative records, so
search_docs works immediately. Run the offline tests with uv run pytest.
Connect a client
Hosted (no install)
The hosted server speaks Streamable HTTP at https://mcp.byteask.ai/mcp and is
backed by the full licensed corpus.
Claude Code:
claude mcp add --transport http byteask-embedded-docs https://mcp.byteask.ai/mcp
{
"mcpServers": {
"byteask-embedded-docs": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.byteask.ai/mcp"]
}
}
}
Local (this repo)
The project-scoped .mcp.json registers the stdio server for clients
that read it. Manually, for Claude Code:
claude mcp add byteask-embedded-docs -- uv run byteask-embedded-mcp
Tools
Input is natural language (or an exact identifier). Output is compact markdown.
| Tool | What it does |
|---|---|
search_docs(query, limit=8) |
Search the corpus; return ranked, page-cited evidence. Each hit has a document title, a section + page citation, the verbatim snippet, and a result_id. A "no confident match" response means not found — do not fabricate. |
get_context(result_id) |
Expand a hit to its full source section. |
request_document(request) |
Ask for a missing document to be added (logged server-side). |
Example output:
## Results for "what Modbus function code writes multiple registers"
### Sample — Modbus Application Protocol (illustrative) — §6.12, p.30
> Function code 16 (0x10), Write Multiple Registers, writes a block of contiguous
> holding registers (1 to 123 registers) in a remote device. ...
_ref: sample:modbus-fc16_
Plug in your own retrieval
The server depends only on a two-method interface
(backend.py):
class SearchBackend(Protocol):
def search(self, query, limit=8, effort=None) -> dict: ...
def get_context(self, result_id, effort=None) -> dict: ...
Implement it, expose a factory make_backend(config) -> SearchBackend, and point the
server at it:
BYTEASK_BACKEND="my_pkg.my_module:make_backend"
The exact return-value contracts are documented at the top of backend.py.
Configuration
All settings are environment variables (loaded from .env; see .env.example).
| Variable | Default | Notes |
|---|---|---|
BYTEASK_BACKEND |
— | module:callable returning a SearchBackend; empty → SampleBackend |
BYTEASK_LOGS |
logs |
where query / request JSONL logs are written |
MCP_TRANSPORT |
stdio |
stdio (local agents) or http |
MCP_HTTP_HOST / MCP_HTTP_PORT |
127.0.0.1 / 8000 |
HTTP bind address |
MCP_HTTP_AUTH_TOKEN |
— | bearer token for HTTP (empty = unauthenticated, dev only) |
MCP_ALLOWED_HOSTS |
— | comma-separated hosts allowed in the Host header (* disables) |
LOG_LEVEL |
INFO |
stderr log verbosity |
MCP_TRANSPORT=http MCP_HTTP_AUTH_TOKEN=$(openssl rand -hex 32) \
uv run byteask-embedded-mcp --host 0.0.0.0 --port 8000
Clients then send Authorization: Bearer <token>. The bundled bearer check is a
shared-secret stub — replace it with real auth (OAuth 2.1 resource server, mTLS,
or a trusted reverse proxy) before exposing publicly. DNS-rebinding protection stays
on independently via MCP_ALLOWED_HOSTS.
Hosted server
You don't need to run anything to use ByteAsk Embedded Docs. The hosted server gives Claude Code, Codex, Cursor, and any MCP client exact, page-cited facts from embedded and firmware reference docs — register maps, protocol function codes, SCPI commands, standard thresholds, datasheet specs. The guarantee: verbatim source, or "no match" — never an invented value.
| Name | byteask-embedded-docs |
| Endpoint | https://mcp.byteask.ai/mcp (Streamable HTTP) |
| Docs & per-client setup | https://docs.byteask.ai/embedded |
This repository is the open-source server that powers that endpoint.
Project layout
src/byteask_embedded_mcp/
server.py # FastMCP app + 3 tools (search_docs, get_context, request_document)
backend.py # SearchBackend protocol + in-memory SampleBackend (swap for real retrieval)
render.py # structured result -> compact markdown
http_auth.py # Streamable HTTP entrypoint + stub bearer-token guard
config.py # server config (transport, logging, backend selection)
schemas.py # Hit / Section result types
obs.py # per-call JSONL logging
tests/ # offline unit tests (renderer, backend, server tools)
assets/ # README demo GIF + its deterministic generator
Security
- stdout stays clean in stdio mode (it is the JSON-RPC channel); all logs go to
stderr /
logs/*.jsonl. - The HTTP bearer check is a stub — unauthenticated if no token is set, a shared secret at best. Harden it before exposing widely.
- DNS-rebinding protection is on by default for the HTTP transport.
Contributing
PRs and issues are welcome.
uv sync # install (incl. dev tools)
uv run pytest # run the offline test suite
A few conventions to keep the server clean:
- The backend seam is the extension point. Retrieval internals (parsing, chunking,
embeddings, ranking) are intentionally out of scope here — build them behind
SearchBackendin your own package, not in this repo. - Keep the dependency surface small and the stdio path free of the HTTP stack.
- Add a test for new behavior; the suite is fully offline (no network, no keys).
License
MIT © ByteAsk
ByteAsk Embedded Docs MCP 질문
ByteAsk Embedded Docs MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
ByteAsk Embedded Docs MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ByteAsk Embedded Docs MCP server는 어떤 결과를 반환하나요?
섹션 및 페이지 인용이 포함된 원문 소스 스니펫을 반환하며, 답변을 지어내는 대신 일치하는 내용이 없을 경우 솔직하게 결과가 없음을 알립니다.
서버에서 제공하는 도구는 무엇인가요?
순위가 지정된 페이지 인용 결과를 제공하는 search_docs, 검색된 항목을 전체 섹션으로 확장하는 get_context, 누락된 문서를 요청하는 request_document 도구를 제공합니다.
API 키 없이 로컬에서 서버를 실행할 수 있나요?
네, 번들로 포함된 SampleBackend가 예시용 공개 지식 레코드를 제공하므로 API 키 없이도 즉시 search_docs를 사용할 수 있습니다.
자체 검색 엔진을 연결하려면 어떻게 해야 하나요?
SearchBackend 인터페이스의 두 가지 메서드를 구현하고, make_backend 팩토리를 노출한 뒤 BYTEASK_BACKEND 환경 변수를 설정하면 됩니다.