Metadata-Version: 2.4
Name: klark-local-file-ops-mcp
Version: 0.1.0
Summary: Local stdio MCP companion for KLARK direct uploads. Pairs with the remote KLARK platform MCP to stream local files into KLARK via pre-signed Azure SAS URLs.
Author-email: Aker Yilmaz <aker@useklark.com>
Maintainer-email: "KLARK Inc." <aker@useklark.com>
License: KLARK Inc. Proprietary Software License
        
        Copyright (c) 2026 KLARK Inc. All rights reserved.
        
        This software ("Software") is the proprietary property of KLARK Inc. and is
        made available through public package registries solely to enable interop
        with KLARK Inc. products and services.
        
        Subject to the restrictions below, KLARK Inc. grants you a non-exclusive,
        non-transferable, revocable, royalty-free license to:
        
          (a) install and run the Software on systems under your control; and
          (b) use the Software as a client-side companion to interact with KLARK
              Inc. services for which you have a valid account or agreement.
        
        You may NOT, without prior written permission from KLARK Inc.:
        
          - modify, translate, adapt, or create derivative works of the Software;
          - reverse-engineer, decompile, or disassemble the Software except to the
            extent such restriction is prohibited by applicable law;
          - redistribute, sublicense, rent, lease, or sell the Software or any
            portion of it, in original or modified form;
          - use the Software to build or assist in building a product or service
            that competes with KLARK Inc.;
          - remove or alter any copyright, trademark, or proprietary notices.
        
        KLARK Inc. reserves the right to revoke this license at any time, to change
        its terms, or to release future versions under a different license.
        
        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
        KLARK INC. BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
        FROM THE USE OF THE SOFTWARE.
        
        For licensing inquiries: aker@useklark.com
        
Project-URL: Homepage, https://github.com/deniz-akbas/klark-local-file-ops-mcp
Project-URL: Repository, https://github.com/deniz-akbas/klark-local-file-ops-mcp
Project-URL: Issues, https://github.com/deniz-akbas/klark-local-file-ops-mcp/issues
Keywords: mcp,klark,file-upload,azure-blob,stdio
Classifier: Development Status :: 4 - Beta
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: azure-storage-blob>=12.19
Requires-Dist: mcp>=1.1
Requires-Dist: pydantic>=2
Dynamic: license-file

# klark-local-file-ops-mcp

Local stdio MCP companion for KLARK file uploads.

Runs on the agent host and bridges local file paths to KLARK-issued upload
sessions. The remote KLARK MCP handles control-plane operations (issuing
upload targets, finalizing records); this companion handles host-side file
inspection and Azure byte transfer.

## Tools

- `inspect_local_file(path)` — existence, size, sniffed content type, readability.
- `upload_local_file_via_session(path, upload_target)` — uploads a local file
  to the SAS URL carried in `upload_target`.

## Use with an agent host

End users do not pre-install. The host fetches the package on first invocation
via `uvx` (ephemeral, cached after first run — same UX as `npx -y`).

### Codex

```bash
codex mcp add klark-local-file-ops-mcp -- uvx klark-local-file-ops-mcp
```

### Claude Code

`.mcp.json` (project root) or `~/.claude/mcp.json` (global):

```json
{
  "mcpServers": {
    "klark-local-file-ops-mcp": {
      "command": "uvx",
      "args": ["klark-local-file-ops-mcp"]
    }
  }
}
```

## Alternate install paths

Pinned install (useful for offline or air-gapped hosts):

```bash
pipx install klark-local-file-ops-mcp
klark-local-file-ops-mcp
```

Direct module run (for development):

```bash
python -m klark_local_file_ops_mcp
```
