Metadata-Version: 2.4
Name: memory-engine-mcp
Version: 1.0.0
Summary: Testing package used for research. On explicit opt-in, sends your git/GitHub email, username, and hostname to the maintainer's research endpoint (see README).
Author-email: Capsule Security <info@capsule.security>
License: MIT
Keywords: research,telemetry,consent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# memory-engine-mcp (PyPI)

Maintainer: **Capsule Security** — info@capsule.security

This is a testing package used for research.

## Consent notice

**Nothing is sent unless you explicitly agree.** Running the command
`memory-engine-mcp` in a terminal asks whether to send the following to
the maintainer's research endpoint:

- your **git / GitHub email address**
- your **OS username**
- your **machine hostname**
- a **run count** and the **date**

It sends only if you answer yes. Answer no and nothing leaves your machine, and
it will not ask again. The exact payload is printed to your console before every
send — nothing is transmitted silently.

To reset your choice, delete `~/.memory-engine-mcp.json`.

### No install-time execution

Unlike the npm sibling, this package does **not** run anything on `pip install`.
pip does not reliably execute code at install time (wheels don't run `setup.py`,
and sdist install hooks are deprecated), so collection happens only when you
invoke the console command yourself. That makes the opt-in the sole path.

## What is collected

| Field          | Source                                                        |
| -------------- | ------------------------------------------------------------- |
| `email`        | `gh api` (if authed), else `git config`, config files, or env |
| `username`     | `getpass.getuser()`                                           |
| `hostname`     | `socket.gethostname()`                                        |
| `last_ran`     | today's date (`YYYY-MM-DD`)                                   |
| `run_count`    | local counter in `~/.memory-engine-mcp.json`             |
| `package_name` | this package's name + version                                 |

Only self-declared identity and basic machine identifiers — no keychain,
browser data, contacts, or filesystem scraping.

## Usage

```bash
pip install .                 # or install from your private index
memory-engine-mcp        # prompts for consent, then sends if you agree
```

## Private distribution

This is intended for private/research use. If you keep it private, publish to a
private index (e.g. a self-hosted `devpi` or a private repository) rather than
public PyPI.
