ByteAsk Embedded Docs MCP sunucusu
AI kodlama ajanlarının gömülü sistem ve firmware referans dokümanlarında; registerlar, protokoller ve standartlar hakkında kelimesi kelimesine, sayfa referanslı kesitler aramasını sağlar.
Ayrıca bilinen adı ByteAsk/ByteAsk-Embedded-MCP, byteask-embedded-mcp
- Yıldızlar
- 26
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.0.1
- Son commit
- 20 Haz 2026
- Lisans
- MIT
ByteAsk Embedded Docs MCP nedir?
AI kodlama ajanlarının gömülü sistem ve firmware referans dokümanlarında; registerlar, protokoller ve standartlar hakkında kelimesi kelimesine, sayfa referanslı kesitler aramasını sağlar.
Özet, projenin README dosyasından oluşturuldu
ByteAsk Embedded Docs MCP sunucusu hakkında
embedded-docs, firmware ve sürücü geliştiricileri için AI kodlama ajanlarına kelimesi kelimesine ve sayfa referanslı teknik dokümantasyon sağlar. Claude Code, Cursor veya Codex gibi ajanların, halüsinasyon riski olmadan tam register offsetlerini, protokol fonksiyon kodlarını ve standart eşik değerlerini getirmesine olanak tanır. Sunucu, kulağa mantıklı gelen ancak yanlış değerler üretmek yerine, referans kılavuzlarından doğrudan kesitler döndürür veya bilgi mevcut olmadığında eşleşme bulunamadı yanıtı verir.
Geliştiriciler bunu Streamable HTTP üzerinden uzak bir servis olarak kullanabilir veya stdio transport kullanarak yerel olarak çalıştırabilirler. Hosted uç nokta tam lisanslı bir veri kümesine erişim sağlarken, yerel sürüm API anahtarları olmadan anında test yapabilmek için bir örnek backend içerir. Kullanıcılar ayrıca sağlanan arayüze özel bir backend bağlayarak kendi veri getirme motorlarını uygulayabilirler. Sistem; veri kümesinde arama yapma, belirli eşleşmeleri tam kaynak bölümlerine genişletme ve yeni dokümanlar talep etme araçlarını içerir.
Neler yapabilirsiniz
- 1Register değerlerini doğrulayınBir AI ajanı, firmware kodunun doğruluğundan emin olmak için belirli register offsetlerini veya bit tanımlarını arayabilir.
- 2İletişim protokollerini uygulayınGeliştiriciler, donanım etkileşimi için gereken tam Modbus fonksiyon kodlarını veya SCPI komutlarını bulmak için bu aracı kullanabilirler.
- 3AI halüsinasyonlarını önleyinSunucu, kodlama ajanlarının teknik özellikler uydurmak yerine atıf yapılmış kanıtlara güvenmesini sağlar.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ByteAsk Embedded Docs MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleByteAsk Embedded Docs MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcpByteAsk Embedded Docs MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"byteask-embedded-mcp": {
"url": "https://mcp.byteask.ai/mcp"
}
}
}ByteAsk Embedded Docs MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"byteask-embedded-mcp": {
"type": "http",
"url": "https://mcp.byteask.ai/mcp"
}
}
}ByteAsk Embedded Docs MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"byteask-embedded-mcp","type":"http","url":"https://mcp.byteask.ai/mcp"}'ByteAsk Embedded Docs MCP'yi Codex içine yükleyin
$ codex mcp add byteask-embedded-mcp --url https://mcp.byteask.ai/mcpByteAsk Embedded Docs MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.byteask-embedded-mcp] url = "https://mcp.byteask.ai/mcp"
ByteAsk Embedded Docs MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcpByteAsk Embedded Docs MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"byteask-embedded-mcp": {
"url": "https://mcp.byteask.ai/mcp",
"type": "http"
}
}
}Yapılandırma
BYTEASK_BACKENDMCP_TRANSPORT
| Ad | Açıklama | Sunucu |
|---|---|---|
| BYTEASK_BACKEND | — | |
| MCP_TRANSPORT | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirbyteask/byteask-embedded-mcp is public and reachablegithub.com/byteask/byteask-embedded-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-06-20github.com/byteask/byteask-embedded-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 1055 msGeçti
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 soruları
ByteAsk Embedded Docs MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http byteask-embedded-mcp https://mcp.byteask.ai/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ByteAsk Embedded Docs MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
ByteAsk Embedded Docs MCP server ne döndürür?
Bölüm ve sayfa atıflarıyla birlikte kaynağın orijinal kesitlerini döndürür; uydurma bir cevap vermek yerine eşleşme bulunamadığında dürüstçe eşleşme olmadığını belirtir.
Sunucu hangi araçları sunar?
Sıralanmış ve sayfa referanslı sonuçlar için search_docs, bir eşleşmeyi tam bölümüne genişletmek için get_context ve eksik bir dokümanı talep etmek için request_document araçlarını sunar.
Sunucuyu API anahtarı olmadan yerel olarak çalıştırabilir miyim?
Evet, paketle birlikte gelen SampleBackend, örnek teşkil eden genel bilgi kayıtlarını sunar; böylece search_docs herhangi bir anahtar gerektirmeden hemen çalışır.
Kendi veri getirme motorumu nasıl entegre edebilirim?
İki metodlu SearchBackend arayüzünü uygulayın, bir make_backend factory fonksiyonu sunun ve BYTEASK_BACKEND ortam değişkenini ayarlayın.