Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Description from the maker (original English)
Page-cited retrieval for embedded docs, datasheets, MISRA, CMSIS, and RTOS references.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
https://mcp.byteask.ai/mcpRun this in your terminal
claude mcp add --transport http embedded-docs https://mcp.byteask.ai/mcpPaste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"embedded-docs": {
"url": "https://mcp.byteask.ai/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"embedded-docs": {
"type": "http",
"url": "https://mcp.byteask.ai/mcp"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
https://mcp.byteask.ai/mcpMenu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
We have not read this server’s tool list yet; we check endpoints in rotation.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026
The registry name was verified against the domain byteask.ai (the registry checks domain ownership)
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
Not checked yet; we check endpoints in rotation
Not checked yet; we check endpoints in rotation
Not checked yet; we read the tool list when we check the endpoint
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed –, and the latest version (1.0.1) reached the registry 5 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
In the same category: Spec Driven Development, Remote Desktop Commander, Intervals MCP
Servers in the same category from other makers, sorted by stars.
Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Remote MCP server for intervals.icu run data and analysis
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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
SearchBackend
seam and power the hosted endpoint at
https://mcp.byteask.ai/mcp. This repo ships
an in-memory
SampleBackend(a few
illustrative, public-knowledge records) so the server runs out of the box.
search_docs reflexively 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.stdio for local agents, Streamable HTTP for hosted.BYTEASK_BACKEND without touching the server.SampleBackend runs immediately. No API keys.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.
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
Codex, Cursor, and other clients (mcp-remote)
{
"mcpServers": { "byteask-embedded-docs": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.byteask.ai/mcp"] } } }
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
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"
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_
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.
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 |
Running over HTTP
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 . 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.
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.
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
logs/*.jsonl.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:
SearchBackend in your own package, not in this repo.MIT © ByteAsk