Metadata-Version: 2.4
Name: jiuwen-migraine-diary
Version: 0.2.0
Summary: MCP headache diary tools backed by the published Chroma MCP server.
License-Expression: Apache-2.0
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp==1.30.0
Dynamic: license-file

# Jiuwen Migraine Diary

A local MCP server for recording self-reported headache experiences.

## Tools

- `create_migraine_entry`: save initial details and return a required question.
- `get_migraine_question`: return one unanswered, unskipped question.
- `answer_migraine_question`: validate and save an answer or explicit skip.
- `get_migraine_entry`: retrieve an entry by ID.

Question definitions are bundled with the package and initialized in Chroma.
Question selection and answer validation run in Python.

## Runtime

Requires Python 3.12 or later and `uvx` available on PATH.
The server launches the published `chroma-mcp==0.2.6` package through uvx
with `pydantic==2.10.6` for compatibility.
Internet access is needed for first-time dependency downloads.
Chroma may download its default embedding model on first document writes.

Default database:
`~/.personal-health-memory/chroma-mcp-diary`

A custom database directory can be supplied with `--data-dir`.

The runtime is separate from Jiuwen's Python environment.
No changes to Jiuwen core are required.

## Data and limitations

Records persist in the configured database directory.
Use the same directory when restarting to retrieve previous records.

This is a self-report diary, not a diagnostic or treatment system.
It does not verify medical accuracy or recommend medications.
A connected AI client may send chat and tool results to its model provider.
The package does not provide input masking.

The current implementation has been tested on macOS with Python 3.12.
Other operating systems have not yet been verified.

## License

Apache-2.0. See LICENSE.
