Carrot MCP

A collection of MCP (Model Context Protocol) servers for various hardware and data interfaces.

Installation

pip

pip install carrot-mcp

This installs all MCP servers (pdf, io, nfc, office) by default.

uv

uv pip install carrot-mcp

Install specific servers only

# pip or uv
pip install carrot-mcp[pdf]
pip install carrot-mcp[io]
pip install carrot-mcp[nfc]
pip install carrot-mcp[office]

Or install sub-packages directly

pip install carrot-mcp-pdf
pip install carrot-mcp-io
pip install carrot-mcp-nfc
pip install carrot-mcp-office

Quick Start

uvx (recommended)

# Run a specific server directly (no install needed)
uvx carrot-mcp-pdf@latest
uvx carrot-mcp-io@latest
uvx carrot-mcp-nfc@latest
uvx carrot-mcp-office@latest

# List available servers
uvx carrot-mcp list

# Add all carrot servers to supported agents
uvx carrot-mcp add

# Remove all carrot servers from agents
uvx carrot-mcp remove

CLI

# List all available servers
carrot-mcp list

# Run a specific server
carrot-mcp run pdf
carrot-mcp run io
carrot-mcp run nfc
carrot-mcp run office

# Add all carrot servers to supported agents
carrot-mcp add

# Remove all carrot servers from agents
carrot-mcp remove

# Run with uv
uv run carrot-mcp run office

Python module

python -m carrot_mcp_pdf
python -m carrot_mcp_io
python -m carrot_mcp_nfc
python -m carrot_mcp_office

Available Servers

Server	Package	Category	Description
PDF	`carrot-mcp-pdf`	Document	PDF processing
Office	`carrot-mcp-office`	Document	Excel & Word automation with auto-backup
IO	`carrot-mcp-io`	Hardware	Serial, TCP, UDP communication
NFC	`carrot-mcp-nfc`	Hardware	NFC reader (PN532, CLRC663)

Document Servers

PDF MCP Tools

Tool	Description
`version`	Get server version info
`get_toc`	Get table of contents with page ranges
`get_pages`	Convert specific pages to markdown (supports multimodal/OCR/force_ocr)
`create_task`	Start background full PDF conversion (multimodal/force_ocr option)
`get_status`	Check progress of background conversion task

Environment variables:

Variable	Description
`CARROT_MCP_MODEL`	Vision model name (required if using OCR)
`CARROT_MCP_APIKEY`	API key for the vision model
`CARROT_MCP_PROXY`	HTTP proxy URL for API calls
`CARROT_MCP_FORCE_MULTIMODAL`	`true` = always return images; `false` = always run OCR

Office MCP Tools

Tool	Description
`version`	Get server version info and backup configuration

Excel Tools

Tool	Description
`workbook_metadata`	Get workbook metadata (sheet names, properties)
`workbook_search`	Search for values in a sheet
`create_sheet`	Create a new sheet (creates workbook if needed)
`rename_sheet`	Rename a sheet
`delete_sheet`	Delete a sheet
`insert_rows`	Insert rows into a sheet
`delete_rows`	Delete rows from a sheet
`insert_columns`	Insert columns into a sheet
`delete_columns`	Delete columns from a sheet
`read_range`	Read cell values from a range
`write_range`	Write a 2D array to a range (supports formulas)
`copy_range`	Copy a range to another location
`delete_range`	Clear cell contents in a range
`read_chart`	Read chart information from a sheet
`write_chart`	Create a chart (bar, line, pie, scatter)
`format_range`	Format cells (font, color, alignment, merge/unmerge)

Word Tools

Tool	Description
`inspect`	Inspect document structure (paragraphs, tables, images)
`insert_para`	Insert a paragraph
`modify_para`	Modify paragraph text
`format_para`	Format a paragraph (style, alignment, font)
`delete_para`	Delete a paragraph
`insert_table`	Insert a table with optional data
`modify_table`	Modify a table cell
`format_table`	Apply a table style
`delete_table`	Delete a table
`insert_image`	Insert an image
`delete_image`	Delete an inline image

Backup Tools

Tool	Description
`backup_history`	List all backup versions of a file
`backup_restore`	Restore a file to a specific backup version

Features:

Auto-backup: All modifications are automatically versioned
Legacy format support: .doc → .docx, .xls → .xlsx via win32com (Windows)
100 version limit with 14-day expiry per file

Environment variables:

Variable	Description
`CARROT_MCP_BACKUP_MAX_VERSIONS`	Max backup versions per file (default: 100)
`CARROT_MCP_BACKUP_MAX_AGE_DAYS`	Days before backup expiry (default: 14)
`CARROT_MCP_BACKUP_ROOT`	Custom backup directory

Hardware Servers

IO MCP Tools

Tool	Description
`version`	Get server version info
`list_transports`	List available transport types and serial ports
`open`	Open a connection (serial, tcp, udp)
`close`	Close a connection
`read`	Blocking read from buffer with timeout
`recv`	Non-blocking read from buffer
`write`	Write data (hex or ascii with escape support)
`script`	Execute a sequence of I/O operations (write/read/wait/flush)
`history`	Get operation history for a connection

NFC MCP Tools

Tool	Description
`version`	Get server version info
`list_readers`	List available reader types and transports
`connect`	Connect to NFC reader
`disconnect`	Disconnect from reader
`find`	Find and activate an NFC card
`transceive`	Raw frame exchange with bit-level control
`exchange`	Data exchange with auto CRC
`reqa`	ISO14443-A REQA
`wupa`	ISO14443-A WUPA
`halt`	ISO14443-A HALT
`select`	ISO14443-A SELECT
`anticoll`	ISO14443-A anti-collision
`field_on`	Turn on RF field
`field_off`	Turn off RF field
`script`	Execute a sequence of NFC operations
`trace_get`	Get trace log entries
`trace_clear`	Clear trace log buffer

MCP Configuration

Auto-config (recommended)

carrot-mcp add

This adds all servers to supported agents (claude, opencode, mimocode).

Manual config

Claude Desktop (~/.claude.json):

{
  "mcpServers": {
    "carrot-pdf": {
      "command": "uvx",
      "args": ["carrot-mcp-pdf@latest"]
    },
    "carrot-office": {
      "command": "uvx",
      "args": ["carrot-mcp-office@latest"]
    },
    "carrot-io": {
      "command": "uvx",
      "args": ["carrot-mcp-io@latest"]
    },
    "carrot-nfc": {
      "command": "uvx",
      "args": ["carrot-mcp-nfc@latest"]
    }
  }
}

OpenCode / MiMoCode (~/.config/opencode/opencode.jsonc or ~/.config/mimocode/mimocode.jsonc):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "carrot-pdf": {
      "type": "local",
      "command": ["uvx", "carrot-mcp-pdf@latest"],
      "enabled": true,
      "environment": {}
    },
    "carrot-office": {
      "type": "local",
      "command": ["uvx", "carrot-mcp-office@latest"],
      "enabled": true,
      "environment": {}
    },
    "carrot-io": {
      "type": "local",
      "command": ["uvx", "carrot-mcp-io@latest"],
      "enabled": true,
      "environment": {}
    },
    "carrot-nfc": {
      "type": "local",
      "command": ["uvx", "carrot-mcp-nfc@latest"],
      "enabled": true,
      "environment": {}
    }
  }
}

Development

# Clone and setup
git clone <repo-url>
cd carrot-mcp
uv sync --all-packages

# Run tests
uv run pytest

# Run tests for specific server
uv run pytest tests/pdf/ -v
uv run pytest tests/office/ -v
uv run pytest tests/io/ -v
uv run pytest tests/nfc/ -v

# Bump version and release
bump.bat                        # interactive
bump.bat carrot-mcp-office      # direct package

License

Apache License 2.0 - see LICENSE for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

carrot_mcp-0.0.7.tar.gz (152.8 kB view details)

Uploaded Jun 29, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

carrot_mcp-0.0.7-py3-none-any.whl (12.1 kB view details)

Uploaded Jun 29, 2026 Python 3

File details

Details for the file carrot_mcp-0.0.7.tar.gz.

File metadata

Download URL: carrot_mcp-0.0.7.tar.gz
Upload date: Jun 29, 2026
Size: 152.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for carrot_mcp-0.0.7.tar.gz
Algorithm	Hash digest
SHA256	`d05e05df60b19e4582a057a8e6a7fe9c2787d780fe00969bd2906426e2368b26`
MD5	`42404dbe711a7eb71b7e2d3e6077ac20`
BLAKE2b-256	`4ef2d5b38b70aeb47ba277e6fcacda9a2903232752f46d3726882814b8283fb8`

See more details on using hashes here.

File details

Details for the file carrot_mcp-0.0.7-py3-none-any.whl.

File metadata

Download URL: carrot_mcp-0.0.7-py3-none-any.whl
Upload date: Jun 29, 2026
Size: 12.1 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for carrot_mcp-0.0.7-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3aeb67f0122ab0290d2d693a1fbab695f07e4b26cc32fe74283f0c565089e5ad`
MD5	`bdd54960657b00a983da6045566c90a4`
BLAKE2b-256	`31c7132ebfe87edb02d94c480379c39c4ab8ee2309e3070d99dfa250b90bdd3d`