Metadata-Version: 2.4
Name: docusense-mcp
Version: 0.1.1
Summary: MCP server that lets AI agents read your PDFs and docs in sections, not wholesale: ~20x fewer tokens, hash-verified citations, version diffs
Keywords: mcp,model-context-protocol,claude,rag,pdf,documents,citations,llm,tokens,agents
Author: hksharma2004
Author-email: hksharma2004 <hksharma2004@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing :: Indexing
Requires-Dist: pymupdf>=1.24
Requires-Dist: markdown-it-py>=3.0
Requires-Dist: pydantic-settings>=2.4
Requires-Dist: pyyaml>=6.0
Requires-Dist: typer>=0.12
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.7
Requires-Dist: mcp>=1.10
Requires-Dist: bm25s>=0.2
Requires-Dist: pystemmer>=2.2
Requires-Dist: fastembed>=0.4
Requires-Dist: numpy>=1.26
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn>=0.30
Requires-Dist: anthropic>=1.0 ; extra == 'anthropic'
Requires-Dist: psycopg[binary,pool]>=3.2 ; extra == 'postgres'
Requires-Dist: pgvector>=0.3 ; extra == 'postgres'
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/hksharma2004/docu-sense
Project-URL: Issues, https://github.com/hksharma2004/docu-sense/issues
Provides-Extra: anthropic
Provides-Extra: postgres
Description-Content-Type: text/markdown

# DocuSense

**Stop pasting whole documents into your agent.**

DocuSense is a local MCP server that lets Claude, Cursor and other AI agents read your PDFs, Word files
and docs *by section and by claim*, so they load the few hundred tokens that answer the question instead
of the whole 50,000-token file. Every answer comes with a citation to the exact passage.

```
pasting the docs   ████████████████████████████████████████  160,179 tokens
vector RAG         ████                                         15,765 tokens
DocuSense          ██                                            6,869 tokens   → 23x less than pasting
```

<!-- mcp-name: io.github.hksharma2004/docusense -->

## Install

```bash
uv tool install docusense-mcp        # or: pipx install docusense-mcp
docusense setup                      # connects to Claude Code
docusense add ~/docs contract.pdf    # files or whole folders
```

That's it. Ask your agent about your documents.

Other clients: `docusense setup claude-desktop`, `docusense setup cursor`, or `docusense setup print`
for a config snippet to paste anywhere. Claude Desktop users can also install the one-click
`docusense.mcpb` from the [releases page](https://github.com/hksharma2004/docu-sense/releases).

Supported files: PDF, Word (.docx), HTML, Markdown, plain text.

## See what you saved

Example:

```console
$ docusense savings
12 agent sessions · 87 tool calls
read via DocuSense:         41,302 tokens
pasting the docs:          912,440 tokens
saved:                     871,138 tokens (22.1x less context)
```

## Why it uses fewer tokens

| You ask | Pasting the docs | Vector RAG | DocuSense |
|---|---|---|---|
| A precise fact, with a citation | 9,090 tokens | 5,362 tokens of nearby chunks | **478 tokens**: the exact paragraph |
| What changed between two versions | 97,895 tokens | 5,292 tokens, can't diff | **2,776 tokens**: just the changes |
| Does document A conflict with B? | 53,194 tokens | 5,111 tokens, hit or miss | **3,615 tokens**: both conflicting passages |

- **Reads like a person.** Your agent sees the table of contents, opens the right section, and reads
  only the paragraph it needs.
- **Tracks versions.** Add a changed file again and DocuSense keeps both versions. Ask what changed
  without loading either one.
- **Finds contradictions** between documents, with both sides cited.
- **Citations you can trust.** Every passage is fingerprinted, so a made-up quote can't pass as a real one.
- **Private and free.** Runs on your machine. No API key, no account, nothing uploaded.

## Great for

- Long specs, API references and design docs while coding in Claude Code or Cursor
- Checking policies against standards and tracking revisions
- Contracts, handbooks and research papers where you need exact quotes and page numbers
- Any agent that keeps re-reading the same large files

If your documents are a few short files that already fit in context, you don't need DocuSense.

## What your agent can do

| | |
|---|---|
| Browse | list documents, view the table of contents, read a section |
| Find | search, find requirements and rules, look up definitions, follow cross-references |
| Cite | get a verified quote, pack evidence into a token budget |
| Compare | list versions, diff versions, see when a line changed, find contradictions, find affected documents |
| Add | add files on its own and track progress |

Set `DOCUSENSE_TOOLS=core` for a smaller tool set if your agent's context is tight.

## Settings

| Variable | Default | |
|---|---|---|
| `DOCUSENSE_HOME` | `~/.docusense` | where your data lives |
| `DOCUSENSE_ADD_ROOTS` | your home folder | folders the agent may add files from |
| `DOCUSENSE_TOOLS` | `all` | `core` for fewer tools |
| `DOCUSENSE_SAVINGS_LOG` | `1` | `0` turns off the local savings log |

Share one library across several agents: `docusense serve-mcp --http` (set `DOCUSENSE_HTTP_TOKEN`
when exposing it beyond localhost).

The first time you add documents, DocuSense downloads a small local search model (~130 MB) once.

## License

MIT
