bitwise-mcp

MichaelAyles/bitwise-mcp

3.4

If you are the rightful owner of bitwise-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP documentation server for embedded developers, designed to ingest large PDF reference manuals, extract register definitions, and provide efficient semantic search.

Tools
4
Resources
0
Prompts
0

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

Listing available PDFs

Example: Searching Documentation

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

Documentation search in action

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