opendockit-mcp 0.3.2__py3-none-any.whl

opendockit_mcp-0.3.2.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.5
+Name: opendockit-mcp
+Version: 0.3.2
+Summary: MCP server that lets an agent read local documents (PDF, Office, HWP and more) as Markdown. Launcher for opendockit[mcp].
+Project-URL: Homepage, https://github.com/hyeonsang010716/OpenDocKit
+Project-URL: Documentation, https://github.com/hyeonsang010716/OpenDocKit/blob/main/docs/integrations.md
+Project-URL: Repository, https://github.com/hyeonsang010716/OpenDocKit
+Project-URL: Issues, https://github.com/hyeonsang010716/OpenDocKit/issues
+Project-URL: Changelog, https://github.com/hyeonsang010716/OpenDocKit/blob/main/CHANGELOG.md
+Author: OpenDocKit contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: docx,hwp,hwpx,llm,markdown,mcp,mcp-server,pdf,pptx,rag,xlsx
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.12
+Requires-Dist: opendockit[mcp]==0.3.2
+Description-Content-Type: text/markdown
+
+# opendockit-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that lets an agent — Claude Desktop, Claude Code, Cursor, VS Code, or
+anything else that speaks the protocol — read the documents on your machine as Markdown: PDF, Word, PowerPoint, Excel,
+CSV, **HWP / HWPX**, OpenDocument, RTF, EPUB, HTML and email. Tables keep their rows and columns, merged cells are
+repeated in every row they cover, and a long document can be read one page, slide or sheet at a time, so it does not fill
+the context.
+
+The server is part of [OpenDocKit](https://github.com/hyeonsang010716/OpenDocKit) (MIT, pure Python, no models, offline).
+This package holds no code: it installs `opendockit[mcp]` at the same version and gives the server a name that can be
+run directly.
+
+<!-- mcp-name: io.github.hyeonsang010716/opendockit -->
+
+## Use
+
+```json
+{
+  "mcpServers": {
+    "opendockit": {
+      "command": "uvx",
+      "args": ["opendockit-mcp", "--root", "/path/to/documents"]
+    }
+  }
+}
+```
+
+`--root` (repeatable, or the `OPENDOCKIT_MCP_ROOTS` environment variable, separated like `PATH`) names the only folders
+the server may read. Without it the server can read any file your user can read.
+
+| Tool | What it returns |
+| --- | --- |
+| `document_outline(path)` | Format, title, size, and the numbered pages / slides / sheets with their titles and lengths — no text |
+| `convert_document(path, sections=None, max_chars=100000)` | The Markdown of the file, or of the pages / slides / sheets asked for (`"3"` or `"2-5"`), followed by the converter's warnings |
+
+- **Read-only and offline.** Both tools are marked read-only, nothing is written, and nothing is sent anywhere. No API
+  key.
+- **The answer is bounded.** One call returns at most `max_chars` characters of the document; a longer one is cut with a
+  note that tells the agent to read the outline and ask for sections.
+- **One file cannot take the server down.** On Linux and macOS every conversion runs in a disposable worker process that
+  is ended after 2 minutes, and on Linux also when it passes 2 GB of memory. On Windows it runs inside the server,
+  without those limits.
+- **The text of a document is data.** A document can contain sentences addressed to the agent. The server returns what
+  the file says; let it read only the folders you would hand the agent yourself.
+
+## Limits
+
+- No OCR: a scanned PDF or a photo comes back as a placeholder with a warning.
+- Legacy `.doc` / `.ppt` need LibreOffice installed.
+- On Windows, HTML, email and EPUB are not supported.
+
+Everything else — the tools in detail, the design notes, the limits — is in the
+[integrations guide](https://github.com/hyeonsang010716/OpenDocKit/blob/main/docs/integrations.md).

opendockit_mcp-0.3.2.dist-info/RECORD

@@ -0,0 +1,5 @@
+opendockit_mcp-0.3.2.dist-info/METADATA,sha256=twpiUdWBTAADWvKIYdS-n9_BWw0HdL8jkeVlKecp1Is,3961
+opendockit_mcp-0.3.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+opendockit_mcp-0.3.2.dist-info/entry_points.txt,sha256=4dvk7UJztvk-W64KoLQvKHGB9wlz3y_6-UIzxaRWLmw,62
+opendockit_mcp-0.3.2.dist-info/licenses/LICENSE,sha256=kRxq4-Gyaq9H_QBWUsYCIPtDO2ReWz_i1v5mPdRaeZU,1080
+opendockit_mcp-0.3.2.dist-info/RECORD,,

opendockit_mcp-0.3.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

opendockit_mcp-0.3.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opendockit-mcp = opendockit.mcp_server:main

opendockit_mcp-0.3.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenDocKit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.