Skip to main content

Interactive CLI inspector for any MCS driver -- inspect tools, test connections, execute calls.

Project description

mcs-inspector

Interactive CLI inspector for any MCS driver.

Point it at a driver, verify the connection, browse discovered tools, and execute them interactively -- all from the terminal.

Installation

# Core inspector (bring your own driver)
pip install mcs-inspector

# With mail-reading driver (IMAP)
pip install mcs-inspector[mailread]

# With mail-sending driver (SMTP)
pip install mcs-inspector[mailsend]

# With composite mail driver (read + send)
pip install mcs-inspector[mail]

# With REST/OpenAPI driver
pip install mcs-inspector[rest]

# Everything
pip install mcs-inspector[all]

Usage

# Inspect a mailbox (read)
mcs-inspect mailread --host imap.example.com --user alice@example.com

# Inspect a mail-sending server
mcs-inspect mailsend --host smtp.example.com --user alice@example.com

# Inspect both read + send as a composite driver
mcs-inspect mail --read-host imap.example.com --read-user alice@example.com \
                 --send-host smtp.example.com --send-user alice@example.com

# Inspect a REST API via OpenAPI spec
mcs-inspect rest https://api.example.com/openapi.json

# Same via python -m
python -m mcs.inspector mailread --host imap.example.com --user alice@example.com

What it does

  1. Connects to the target system and verifies the driver works
  2. Lists all discovered tools in a rich table
  3. Inspects any tool in detail (parameters, types, descriptions)
  4. Executes tools interactively -- enter arguments, see results

Programmatic use

from mcs.inspector import run_inspector
from mcs.driver.mailread import MailreadToolDriver

td = MailreadToolDriver(host="...", user="...", password="...")
run_inspector(td, title="Mailread Inspector")

Links

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcs_inspector-0.1.0.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcs_inspector-0.1.0-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

Details for the file mcs_inspector-0.1.0.tar.gz.

File metadata

  • Download URL: mcs_inspector-0.1.0.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for mcs_inspector-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f14a56f5beb99f5b67a77cf2f14b4fb5cdc54d1ce014364e0ddbdd33fe02d3c9
MD5 1426a4c35042e2fa886b5288aef5becc
BLAKE2b-256 c544f6dffe7142f2024aed9e36bb7593385742fdbe3dde40f12799267defaaac

See more details on using hashes here.

File details

Details for the file mcs_inspector-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: mcs_inspector-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for mcs_inspector-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ffd58a8a4b1e1912c6f5c15b89f53cc68d6d8b4da0c5a6ad44e5cc9b0331b2be
MD5 089aa5be04808b2e817adb00a299830b
BLAKE2b-256 b174fe5135c2ac5505fbe8d91ed71709663b00d7d05030a1aa5ba5193076a5d2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page