pdfco-mcp 0.0.5__tar.gz → 0.0.6__tar.gz

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfco-mcp
-Version: 0.0.5
+Version: 0.0.6
 Summary: MCP server for PDF.Co
 Project-URL: Homepage, https://pdf.co
 Project-URL: Documentation, https://developer.pdf.co
@@ -81,6 +81,26 @@ PDF.co MCP Server provides [PDF.co API](https://pdf.co) functionality through th
 1. Sign up at [PDF.co website](https://pdf.co)
 2. Get your API key from the dashboard
 
+### 📦 Install UV
+You need to install UV (a fast Python packaging tool) to use this MCP server:
+
+#### macOS and Linux
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### Windows
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+#### Alternative Installation Methods
+- **Homebrew**: `brew install uv`
+- **PyPI with pipx**: `pipx install uv`
+- **PyPI with pip**: `pip install uv`
+
+For more installation options and details, see the [UV installation guide](https://docs.astral.sh/uv/getting-started/installation/).
+
 ### MCP Server Setup
 
 #### Cursor IDE Configuration

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/README.md

@@ -36,6 +36,26 @@ PDF.co MCP Server provides [PDF.co API](https://pdf.co) functionality through th
 1. Sign up at [PDF.co website](https://pdf.co)
 2. Get your API key from the dashboard
 
+### 📦 Install UV
+You need to install UV (a fast Python packaging tool) to use this MCP server:
+
+#### macOS and Linux
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+#### Windows
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+#### Alternative Installation Methods
+- **Homebrew**: `brew install uv`
+- **PyPI with pipx**: `pipx install uv`
+- **PyPI with pip**: `pip install uv`
+
+For more installation options and details, see the [UV installation guide](https://docs.astral.sh/uv/getting-started/installation/).
+
 ### MCP Server Setup
 
 #### Cursor IDE Configuration

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/services/client.py

@@ -13,7 +13,7 @@ print(f"pdfco-mcp version: {__version__}", file=sys.stderr)
 
 
 @asynccontextmanager
-async def PDFCoClient(api_key: str = None) -> AsyncGenerator[AsyncClient, None]:
+async def PDFCoClient(api_key: str | None = None) -> AsyncGenerator[AsyncClient, None]:
     # Use provided API key, fall back to environment variable
     x_api_key = api_key or X_API_KEY
 

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/services/pdf.py

@@ -4,36 +4,36 @@ from pdfco.mcp.services.client import PDFCoClient
 
 
 async def convert_to(
-    _from: str, _to: str, params: ConversionParams, api_key: str = None
+    _from: str, _to: str, params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request(f"{_from}/convert/to/{_to}", params, api_key=api_key)
 
 
 async def convert_from(
-    _to: str, _from: str, params: ConversionParams, api_key: str = None
+    _to: str, _from: str, params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request(f"{_to}/convert/from/{_from}", params, api_key=api_key)
 
 
-async def merge_pdf(params: ConversionParams, api_key: str = None) -> BaseResponse:
+async def merge_pdf(params: ConversionParams, api_key: str | None = None) -> BaseResponse:
     return await request("pdf/merge2", params, api_key=api_key)
 
 
-async def split_pdf(params: ConversionParams, api_key: str = None) -> BaseResponse:
+async def split_pdf(params: ConversionParams, api_key: str | None = None) -> BaseResponse:
     return await request("pdf/split", params, api_key=api_key)
 
 
 async def get_pdf_form_fields_info(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/info/fields", params, api_key=api_key)
 
 
 async def fill_pdf_form_fields(
     params: ConversionParams,
-    fields: list = None,
-    annotations: list = None,
-    api_key: str = None,
+    fields: list | None = None,
+    annotations: list | None = None,
+    api_key: str | None = None,
 ) -> BaseResponse:
     custom_payload = {}
     if fields:
@@ -46,7 +46,7 @@ async def fill_pdf_form_fields(
 
 
 async def pdf_add(
-    params: ConversionParams, api_key: str = None, **kwargs
+    params: ConversionParams, api_key: str | None = None, **kwargs
 ) -> BaseResponse:
     """General PDF Add function that supports all PDF Add API parameters"""
     custom_payload = {}
@@ -65,8 +65,8 @@ async def find_text_in_pdf(
     params: ConversionParams,
     search_string: str,
     regex_search: bool = False,
-    word_matching_mode: str = None,
-    api_key: str = None,
+    word_matching_mode: str | None = None,
+    api_key: str | None = None,
 ) -> BaseResponse:
     custom_payload = {"searchString": search_string, "regexSearch": regex_search}
     if word_matching_mode:
@@ -77,29 +77,29 @@ async def find_text_in_pdf(
 
 
 async def find_table_in_pdf(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/find/table", params, api_key=api_key)
 
 
 async def make_pdf_searchable(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/makesearchable", params, api_key=api_key)
 
 
 async def make_pdf_unsearchable(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/makeunsearchable", params, api_key=api_key)
 
 
-async def get_pdf_info(params: ConversionParams, api_key: str = None) -> BaseResponse:
+async def get_pdf_info(params: ConversionParams, api_key: str | None = None) -> BaseResponse:
     return await request("pdf/info", params, api_key=api_key)
 
 
 async def add_pdf_password(
-    params: ConversionParams, api_key: str = None, **kwargs
+    params: ConversionParams, api_key: str | None = None, **kwargs
 ) -> BaseResponse:
     return await request(
         "pdf/security/add", params, custom_payload=kwargs, api_key=api_key
@@ -107,17 +107,17 @@ async def add_pdf_password(
 
 
 async def remove_pdf_password(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/security/remove", params, api_key=api_key)
 
 
-async def parse_invoice(params: ConversionParams, api_key: str = None) -> BaseResponse:
+async def parse_invoice(params: ConversionParams, api_key: str | None = None) -> BaseResponse:
     return await request("ai-invoice-parser", params, api_key=api_key)
 
 
 async def extract_pdf_attachments(
-    params: ConversionParams, api_key: str = None
+    params: ConversionParams, api_key: str | None = None
 ) -> BaseResponse:
     return await request("pdf/attachments/extract", params, api_key=api_key)
 
@@ -125,8 +125,8 @@ async def extract_pdf_attachments(
 async def request(
     endpoint: str,
     params: ConversionParams,
-    custom_payload: dict = None,
-    api_key: str = None,
+    custom_payload: dict | None = None,
+    api_key: str | None = None,
 ) -> BaseResponse:
     payload = params.parse_payload(async_mode=True)
     if custom_payload:

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/conversion.py

@@ -46,7 +46,7 @@ async def pdf_to_json(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -113,7 +113,7 @@ async def pdf_to_csv(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -180,7 +180,7 @@ async def pdf_to_text(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -247,7 +247,7 @@ async def pdf_to_xls(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -314,7 +314,7 @@ async def pdf_to_xlsx(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -381,7 +381,7 @@ async def pdf_to_xml(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -448,7 +448,7 @@ async def pdf_to_html(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -520,7 +520,7 @@ async def pdf_to_image(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -576,7 +576,7 @@ async def document_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -624,7 +624,7 @@ async def csv_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -668,7 +668,7 @@ async def image_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -738,7 +738,7 @@ async def webpage_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -827,7 +827,7 @@ async def html_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -893,7 +893,7 @@ async def email_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -936,7 +936,7 @@ async def excel_to_csv(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -978,7 +978,7 @@ async def excel_to_json(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -1020,7 +1020,7 @@ async def excel_to_html(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -1062,7 +1062,7 @@ async def excel_to_txt(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -1104,7 +1104,7 @@ async def excel_to_xml(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -1146,7 +1146,7 @@ async def excel_to_pdf(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/document.py

@@ -23,7 +23,7 @@ async def pdf_info_reader(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/editing.py

@@ -48,7 +48,7 @@ async def pdf_add_annotations_images_fields(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/extraction.py

@@ -12,7 +12,7 @@ async def ai_invoice_parser(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -42,7 +42,7 @@ async def extract_attachments(
     password: str = Field(description="Password of PDF file. (Optional)", default=""),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/file.py

@@ -10,7 +10,7 @@ async def upload_file(
     file_path: str = Field(description="The absolute path to the file to upload"),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/form.py

@@ -21,7 +21,7 @@ async def read_pdf_forms_info(
     password: str = Field(description="Password of PDF file. (Optional)", default=""),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -59,7 +59,7 @@ async def fill_pdf_forms(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -109,7 +109,7 @@ async def create_fillable_forms(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/job.py

@@ -12,7 +12,7 @@ async def get_job_check(
     job_id: str = Field(description="The ID of the job to get the status of"),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -58,7 +58,7 @@ async def wait_job_completion(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/modification.py

@@ -23,7 +23,7 @@ async def pdf_merge(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -63,7 +63,7 @@ async def pdf_split(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/search.py

@@ -38,7 +38,7 @@ async def find_text(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -80,7 +80,7 @@ async def find_table(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/searchable.py

@@ -34,7 +34,7 @@ async def pdf_make_searchable(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -80,7 +80,7 @@ async def pdf_make_unsearchable(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pdfco/mcp/tools/apis/security.py

@@ -67,7 +67,7 @@ async def pdf_add_password(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """
@@ -140,7 +140,7 @@ async def pdf_remove_password(
     ),
     api_key: str = Field(
         description="PDF.co API key. If not provided, will use X_API_KEY environment variable. (Optional)",
-        default=None,
+        default="",
     ),
 ) -> BaseResponse:
     """

{pdfco_mcp-0.0.5 → pdfco_mcp-0.0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pdfco-mcp"
-version = "0.0.5"
+version = "0.0.6"
 description = "MCP server for PDF.Co"
 authors = [
     { name = "PDF.Co", email = "support@pdf.co" }