bitwise-mcp

MCP server for embedded developers. Ingests PDF reference manuals (1000+ pages), extracts register definitions, and provides fast semantic search.

Features

• PDF Ingestion - Parses large reference manuals preserving structure
• Register Table Extraction - Detects and converts register definitions to structured JSON
• Hybrid Search - Combines keyword matching (SQLite FTS5) with semantic similarity (FAISS)
• Compact Output - Formats responses to minimize token usage

Installation

poetry install

# Add to Claude Code
claude mcp add embedded-docs --command poetry --args "run" "mcp-embedded-docs" "serve" --cwd "<path-to-this-repo>"

Restart Claude Code after adding the server.

Usage

Place PDFs in a docs/ directory, then in Claude Code:

What PDFs are available?
Ingest any files that haven't been ingested yet
What's the base address for FlexCAN0?

Example: Checking Available PDFs

Example: Searching Documentation

The MCP server automatically queries the indexed documentation when you ask questions:

CLI Usage

Or use CLI directly:

poetry run mcp-embedded-docs ingest docs/manual.pdf --title "MCU Manual"
poetry run mcp-embedded-docs list  # View indexed documents

MCP Tools

• search_docs - Search documentation with hybrid retrieval
• find_register - Find specific register definitions
• list_docs - List all documentation files with status (indexed + available)
• ingest_docs - Ingest documentation files into the search index
• remove_docs - Remove documents from the search index by ID

Tech Stack

Python 3.10+ • PyMuPDF • pdfplumber • sentence-transformers • FAISS • SQLite FTS5

Performance

Tested: S32K144 Reference Manual (2,179 pages, 14MB) Results: 3min indexing, <500ms search, ~500MB memory

License

MIT