Metadata-Version: 2.4
Name: acatome-mcp
Version: 0.2.3
Summary: MCP server exposing acatome-store tools
Project-URL: Homepage, https://github.com/acatome/acatome-mcp
Project-URL: Repository, https://github.com/acatome/acatome-mcp
Project-URL: Issues, https://github.com/acatome/acatome-mcp/issues
Author-email: Reto Stamm <reto@retostamm.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Keywords: llm,mcp,notes,scientific-papers,semantic-search
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Requires-Dist: acatome-store>=0.1.0
Requires-Dist: mcp>=1.0
Provides-Extra: dev
Requires-Dist: black>=24.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Description-Content-Type: text/markdown

# acatome-mcp

A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that exposes the acatome paper library to LLMs. Provides tools for reading papers, searching the library, and managing notes.

## Features

- **3 tools** — `paper`, `search`, `notes`
- **URI addressing** — `slug:`, `doi:`, `arxiv:`, `s2:` schemes with view routing
- **Paginated views** — toc, chunk, page, figure, abstract, summary
- **Semantic search** — query across all ingested papers
- **Notes CRUD** — annotate papers, chunks, and figures
- **Supplement support** — scoped views for supplementary materials

## Installation

```bash
uv pip install -e .
```

## Usage

Run as an MCP server:

```bash
acatome-mcp
```

## URI Examples

```
slug:abc12                    # paper overview
slug:abc12/toc                # table of contents
slug:abc12/chunk/5            # block 5
doi:10.1234/paper/abstract    # abstract by DOI
slug:abc12/notes              # all notes on paper
slug:abc12/supplement/s1/toc  # supplement TOC
```

## Dependencies

- **acatome-store** — paper storage and search backend

## Testing

```bash
uv run python -m pytest tests/ -v
```

## License

GPL-3.0-or-later — see [LICENSE](LICENSE).
