# mcp-kindle

`mcp-kindle` is a read-only, source-scoped MCP server for local Kindle library data.

Version `0.1.0` reads from the local Kindle database or XML export cache. It is intended for direct LLM read access without exposing any write path, and follows the shared conventions documented in `mcp-source-playbook` and `mcp-source-foundation`.

## Implemented

- MCP stdio server via `mcp-kindle-server`
- profile and health reporting
- library reads through `kindle_library`
- focused unit tests for XML parsing and profile behavior

## Tools

- `kindle_profile`
- `kindle_health`
- `kindle_library`

## Configuration

At least one local source must be available:

```bash
export KINDLE_DB_PATH="/path/to/kindle.db"
export KINDLE_XML_PATH="/path/to/KindleSyncMetadataCache.xml"
```

## CLI

```bash
mcp-kindle profile --format json
mcp-kindle library --format json
mcp-kindle-server
```

## Safety

- read-only by default
- local-file based, with no cloud mutation path in v1
- no credentials are required unless a future cloud connector is added

## Development

```bash
python -m pytest
```