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.1.tar.gz (15.0 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.1-py3-none-any.whl (15.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mcs_inspector-0.1.1.tar.gz
  • Upload date:
  • Size: 15.0 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.1.tar.gz
Algorithm Hash digest
SHA256 d43cf7017f05e114b1f3f52d12a116891720c81729d33f7c3192528e483361fe
MD5 f1524b8b221f2878910e597c3873c5b8
BLAKE2b-256 293b425225447bccdf00feded35cfbe85cdf52f489676ece65d3807609e86f77

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mcs_inspector-0.1.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b882c3c8743efb7b97382b36098e80fdd2306e9f708e9ad9b7555bbbc35ff7f5
MD5 c09fa72c7bc9abef5e891da71ea37c10
BLAKE2b-256 5df32876c9f3942e98882525e6e6deb36604c22c3f744409250318ed3e14c6e3

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