pdf-table-pull-lite 1.2.0__tar.gz → 1.2.1__tar.gz

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 What changed in pdf-table-pull-lite, newest first.
 
+## 1.2.1 - 2026-11-04
+
+- Fix: installing from the MCP Registry now starts the MCP server. Before, it started the plain command-line tool by mistake.
+- New: `pdf-table-pull-lite mcp` starts the MCP server. `uvx pdf-table-pull-lite mcp` works too. The old `pdf-table-pull-lite-mcp` command still works.
+- To read a file that is named `mcp`, use `./mcp`.
+
 ## 1.2.0 - 2026-11-04
 
 - MCP tool now has safety labels (tool annotations) so AI apps know what it does:

{pdf_table_pull_lite-1.2.0/pdf_table_pull_lite.egg-info → pdf_table_pull_lite-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdf-table-pull-lite
-Version: 1.2.0
+Version: 1.2.1
 Summary: Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server.
 Author: Tidy Byte Tools
 License-Expression: MIT
@@ -43,9 +43,14 @@ Dynamic: license-file
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-from-claude-desktop-or-cursor-mcp)
+[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-with-your-ai-app-mcp)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-green.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.tidybytetools/pdf-table-pull-lite)
+[![PyPI downloads](https://img.shields.io/pypi/dm/pdf-table-pull-lite.svg)](https://pypistats.org/packages/pdf-table-pull-lite)
+[![Glama score](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite/badges/score.svg)](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite)
 
-Free tool that pulls the tables out of a text PDF and saves each one as a CSV file.
+**Free. No API key. Runs on your own computer, so your PDFs stay with you.**
+
+A tool that pulls the tables out of a text PDF and saves each one as a CSV file.
 Need Excel output, scanned PDFs or tables joined across pages? The paid version does that: **[pdf-table-pull on Gumroad](https://tidybyte.gumroad.com/l/hkxqxh)**
 
 Runs on your own computer, so your PDFs are never uploaded anywhere. MIT license. Python 3.10 or newer, on Windows, Mac and Linux.
@@ -129,9 +134,9 @@ All of these are free and open source. Pick what fits you.
 
 This tool is built on pdfplumber. If you want full control in your own code, use pdfplumber or Camelot directly.
 
-## Use it from Claude Desktop or Cursor (MCP)
+## Use it with your AI app (MCP)
 
-There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. It needs [uv](https://docs.astral.sh/uv/).
+There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. No API key or account is needed. It needs [uv](https://docs.astral.sh/uv/), which gives you the `uvx` command.
 
 Run it by hand to check it starts (it waits quietly for an app to talk to it):
 
@@ -139,7 +144,30 @@ Run it by hand to check it starts (it waits quietly for an app to talk to it):
 uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
 ```
 
-Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
+Shorter way to start the same server: `uvx pdf-table-pull-lite mcp`.
+
+Pick your app below and copy the block. Restart the app after you save.
+
+### Claude Desktop
+
+Open **Settings > Developer > Edit Config**. That opens `claude_desktop_config.json`. Add this:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+If Claude says it can't find `uvx`, run `which uvx` (Mac/Linux) or `where uvx` (Windows) and put that full path in `"command"`.
+
+### Cursor
+
+Put the same block in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
 
 ```json
 {
@@ -152,6 +180,69 @@ Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
 }
 ```
 
+### VS Code
+
+VS Code uses `servers`, not `mcpServers`. Put this in `.vscode/mcp.json` in your project, or run **MCP: Open User Configuration** to use it everywhere:
+
+```json
+{
+  "servers": {
+    "pdf-table-pull-lite": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+Or add it with one command:
+
+```
+code --add-mcp '{"name":"pdf-table-pull-lite","type":"stdio","command":"uvx","args":["--from","pdf-table-pull-lite","pdf-table-pull-lite-mcp"]}'
+```
+
+### Cline
+
+In the Cline panel, click the **MCP Servers** icon, open **Configure**, then click **Configure MCP Servers**. Add this inside `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Codex
+
+One command:
+
+```
+codex mcp add pdf-table-pull-lite -- uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
+```
+
+Or add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.pdf-table-pull-lite]
+command = "uvx"
+args = ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+```
+
+### Gemini CLI
+
+This repo is also a Gemini CLI extension. Install it with:
+
+```
+gemini extensions install https://github.com/tidybytetools/pdf-table-pull-lite
+```
+
 Tool: `extract_pdf_tables(path, pages="", strategy="auto", output_dir="")`. It returns a list with the CSV text of each table. If you set `output_dir`, it saves the CSVs there and returns the file paths instead.
 
 ## For AI agents

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/README.md

@@ -11,9 +11,14 @@
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-from-claude-desktop-or-cursor-mcp)
+[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-with-your-ai-app-mcp)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-green.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.tidybytetools/pdf-table-pull-lite)
+[![PyPI downloads](https://img.shields.io/pypi/dm/pdf-table-pull-lite.svg)](https://pypistats.org/packages/pdf-table-pull-lite)
+[![Glama score](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite/badges/score.svg)](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite)
 
-Free tool that pulls the tables out of a text PDF and saves each one as a CSV file.
+**Free. No API key. Runs on your own computer, so your PDFs stay with you.**
+
+A tool that pulls the tables out of a text PDF and saves each one as a CSV file.
 Need Excel output, scanned PDFs or tables joined across pages? The paid version does that: **[pdf-table-pull on Gumroad](https://tidybyte.gumroad.com/l/hkxqxh)**
 
 Runs on your own computer, so your PDFs are never uploaded anywhere. MIT license. Python 3.10 or newer, on Windows, Mac and Linux.
@@ -97,9 +102,9 @@ All of these are free and open source. Pick what fits you.
 
 This tool is built on pdfplumber. If you want full control in your own code, use pdfplumber or Camelot directly.
 
-## Use it from Claude Desktop or Cursor (MCP)
+## Use it with your AI app (MCP)
 
-There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. It needs [uv](https://docs.astral.sh/uv/).
+There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. No API key or account is needed. It needs [uv](https://docs.astral.sh/uv/), which gives you the `uvx` command.
 
 Run it by hand to check it starts (it waits quietly for an app to talk to it):
 
@@ -107,7 +112,30 @@ Run it by hand to check it starts (it waits quietly for an app to talk to it):
 uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
 ```
 
-Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
+Shorter way to start the same server: `uvx pdf-table-pull-lite mcp`.
+
+Pick your app below and copy the block. Restart the app after you save.
+
+### Claude Desktop
+
+Open **Settings > Developer > Edit Config**. That opens `claude_desktop_config.json`. Add this:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+If Claude says it can't find `uvx`, run `which uvx` (Mac/Linux) or `where uvx` (Windows) and put that full path in `"command"`.
+
+### Cursor
+
+Put the same block in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
 
 ```json
 {
@@ -120,6 +148,69 @@ Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
 }
 ```
 
+### VS Code
+
+VS Code uses `servers`, not `mcpServers`. Put this in `.vscode/mcp.json` in your project, or run **MCP: Open User Configuration** to use it everywhere:
+
+```json
+{
+  "servers": {
+    "pdf-table-pull-lite": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+Or add it with one command:
+
+```
+code --add-mcp '{"name":"pdf-table-pull-lite","type":"stdio","command":"uvx","args":["--from","pdf-table-pull-lite","pdf-table-pull-lite-mcp"]}'
+```
+
+### Cline
+
+In the Cline panel, click the **MCP Servers** icon, open **Configure**, then click **Configure MCP Servers**. Add this inside `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Codex
+
+One command:
+
+```
+codex mcp add pdf-table-pull-lite -- uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
+```
+
+Or add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.pdf-table-pull-lite]
+command = "uvx"
+args = ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+```
+
+### Gemini CLI
+
+This repo is also a Gemini CLI extension. Install it with:
+
+```
+gemini extensions install https://github.com/tidybytetools/pdf-table-pull-lite
+```
+
 Tool: `extract_pdf_tables(path, pages="", strategy="auto", output_dir="")`. It returns a list with the CSV text of each table. If you set `output_dir`, it saves the CSVs there and returns the file paths instead.
 
 ## For AI agents

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1/pdf_table_pull_lite.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdf-table-pull-lite
-Version: 1.2.0
+Version: 1.2.1
 Summary: Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server.
 Author: Tidy Byte Tools
 License-Expression: MIT
@@ -43,9 +43,14 @@ Dynamic: license-file
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/pdf-table-pull-lite/blob/main/LICENSE)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
-[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-from-claude-desktop-or-cursor-mcp)
+[![MCP server](https://img.shields.io/badge/MCP-stdio-purple.svg)](#use-it-with-your-ai-app-mcp)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-green.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.tidybytetools/pdf-table-pull-lite)
+[![PyPI downloads](https://img.shields.io/pypi/dm/pdf-table-pull-lite.svg)](https://pypistats.org/packages/pdf-table-pull-lite)
+[![Glama score](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite/badges/score.svg)](https://glama.ai/mcp/servers/tidybytetools/pdf-table-pull-lite)
 
-Free tool that pulls the tables out of a text PDF and saves each one as a CSV file.
+**Free. No API key. Runs on your own computer, so your PDFs stay with you.**
+
+A tool that pulls the tables out of a text PDF and saves each one as a CSV file.
 Need Excel output, scanned PDFs or tables joined across pages? The paid version does that: **[pdf-table-pull on Gumroad](https://tidybyte.gumroad.com/l/hkxqxh)**
 
 Runs on your own computer, so your PDFs are never uploaded anywhere. MIT license. Python 3.10 or newer, on Windows, Mac and Linux.
@@ -129,9 +134,9 @@ All of these are free and open source. Pick what fits you.
 
 This tool is built on pdfplumber. If you want full control in your own code, use pdfplumber or Camelot directly.
 
-## Use it from Claude Desktop or Cursor (MCP)
+## Use it with your AI app (MCP)
 
-There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. It needs [uv](https://docs.astral.sh/uv/).
+There is a small free MCP server built in. It gives your AI app one tool, `extract_pdf_tables`. No API key or account is needed. It needs [uv](https://docs.astral.sh/uv/), which gives you the `uvx` command.
 
 Run it by hand to check it starts (it waits quietly for an app to talk to it):
 
@@ -139,7 +144,30 @@ Run it by hand to check it starts (it waits quietly for an app to talk to it):
 uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
 ```
 
-Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
+Shorter way to start the same server: `uvx pdf-table-pull-lite mcp`.
+
+Pick your app below and copy the block. Restart the app after you save.
+
+### Claude Desktop
+
+Open **Settings > Developer > Edit Config**. That opens `claude_desktop_config.json`. Add this:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+If Claude says it can't find `uvx`, run `which uvx` (Mac/Linux) or `where uvx` (Windows) and put that full path in `"command"`.
+
+### Cursor
+
+Put the same block in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
 
 ```json
 {
@@ -152,6 +180,69 @@ Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
 }
 ```
 
+### VS Code
+
+VS Code uses `servers`, not `mcpServers`. Put this in `.vscode/mcp.json` in your project, or run **MCP: Open User Configuration** to use it everywhere:
+
+```json
+{
+  "servers": {
+    "pdf-table-pull-lite": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+    }
+  }
+}
+```
+
+Or add it with one command:
+
+```
+code --add-mcp '{"name":"pdf-table-pull-lite","type":"stdio","command":"uvx","args":["--from","pdf-table-pull-lite","pdf-table-pull-lite-mcp"]}'
+```
+
+### Cline
+
+In the Cline panel, click the **MCP Servers** icon, open **Configure**, then click **Configure MCP Servers**. Add this inside `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "pdf-table-pull-lite": {
+      "command": "uvx",
+      "args": ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Codex
+
+One command:
+
+```
+codex mcp add pdf-table-pull-lite -- uvx --from pdf-table-pull-lite pdf-table-pull-lite-mcp
+```
+
+Or add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.pdf-table-pull-lite]
+command = "uvx"
+args = ["--from", "pdf-table-pull-lite", "pdf-table-pull-lite-mcp"]
+```
+
+### Gemini CLI
+
+This repo is also a Gemini CLI extension. Install it with:
+
+```
+gemini extensions install https://github.com/tidybytetools/pdf-table-pull-lite
+```
+
 Tool: `extract_pdf_tables(path, pages="", strategy="auto", output_dir="")`. It returns a list with the CSV text of each table. If you set `output_dir`, it saves the CSVs there and returns the file paths instead.
 
 ## For AI agents

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/pdf_table_pull_lite.egg-info/SOURCES.txt

@@ -15,6 +15,7 @@ pdf_table_pull_lite.egg-info/requires.txt
 pdf_table_pull_lite.egg-info/top_level.txt
 tests/test_lite.py
 tests/test_mcp.py
+tests/test_mcp_subcommand.py
 tests/fixtures/empty.pdf
 tests/fixtures/plain.pdf
 tests/fixtures/ruled.pdf

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/pdf_table_pull_lite.py

@@ -11,7 +11,7 @@ Usage:
 """
 import argparse, csv, os, re, sys
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"
 PRO_URL = "https://tidybyte.gumroad.com/l/hkxqxh"
 PRO_LINE = f"Need Excel output, scanned PDFs or tables joined across pages? pdf-table-pull (paid): {PRO_URL}"
 
@@ -93,7 +93,20 @@ def write_csv(tables, out_dir):
     return paths
 
 
+def run_mcp():
+    """Start the stdio MCP server (needs the mcp package, which pip installs for you)."""
+    try:
+        import pdf_table_pull_lite_mcp
+    except ImportError as e:
+        print(f"error: the MCP server needs the mcp package ({e}). Run: pip install pdf-table-pull-lite", file=sys.stderr)
+        return 1
+    pdf_table_pull_lite_mcp.main()
+    return 0
+
 def main(argv=None):
+    argv = sys.argv[1:] if argv is None else argv
+    if argv == ["mcp"]:
+        return run_mcp()
     ap = argparse.ArgumentParser(prog="pdf-table-pull-lite",
                                  description="Pull tables out of a text PDF into CSV files (one file per table).",
                                  epilog=PRO_LINE)

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdf-table-pull-lite"
-version = "1.2.0"
+version = "1.2.1"
 description = "Pull the tables out of a text PDF into CSV files. Runs locally. CLI and MCP server."
 readme = "README.md"
 license = "MIT"

{pdf_table_pull_lite-1.2.0 → pdf_table_pull_lite-1.2.1}/server.json

@@ -8,17 +8,24 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/tidybytetools/pdf-table-pull-lite",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "packages": [
     {
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "pdf-table-pull-lite",
-      "version": "1.2.0",
+      "version": "1.2.1",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"
-      }
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp",
+          "description": "Starts the MCP server instead of the command-line tool."
+        }
+      ]
     }
   ]
 }

pdf_table_pull_lite-1.2.1/tests/test_mcp_subcommand.py

@@ -0,0 +1,44 @@
+"""`pdf-table-pull-lite mcp` starts the MCP server (this is how the MCP Registry launches it)."""
+import asyncio, os, subprocess, sys, unittest
+HERE = os.path.dirname(os.path.abspath(__file__))
+ROOT = os.path.dirname(HERE)
+
+try:
+    from mcp import ClientSession, StdioServerParameters
+    from mcp.client.stdio import stdio_client
+except ImportError:
+    ClientSession = None
+
+ANN = {'readOnlyHint': False, 'destructiveHint': True, 'idempotentHint': True, 'openWorldHint': False}
+
+
+async def _tools():
+    params = StdioServerParameters(command=sys.executable, args=[os.path.join(ROOT, "pdf_table_pull_lite.py"), "mcp"], cwd=ROOT)
+    async with stdio_client(params) as (r, w):
+        async with ClientSession(r, w) as s:
+            await s.initialize()
+            return (await s.list_tools()).tools
+
+
+@unittest.skipIf(ClientSession is None, "mcp not installed")
+class McpSubcommand(unittest.TestCase):
+    def test_mcp_subcommand_lists_tool_with_annotations(self):
+        tools = asyncio.run(_tools())
+        self.assertEqual([t.name for t in tools], ["extract_pdf_tables"])
+        ann = tools[0].annotations
+        self.assertIsNotNone(ann)
+        for k, v in ANN.items():
+            self.assertIs(getattr(ann, k), v, k)
+
+
+class CliStillWorks(unittest.TestCase):
+    def test_version_and_help(self):
+        out = subprocess.run([sys.executable, os.path.join(ROOT, "pdf_table_pull_lite.py"), "--version"], capture_output=True, text=True)
+        self.assertEqual(out.returncode, 0)
+        self.assertEqual(out.stdout.strip(), "1.2.1")
+        h = subprocess.run([sys.executable, os.path.join(ROOT, "pdf_table_pull_lite.py"), "--help"], capture_output=True, text=True)
+        self.assertEqual(h.returncode, 0)
+
+
+if __name__ == "__main__":
+    unittest.main()