quantified-self-mcp 0.1.0__tar.gz

quantified_self_mcp-0.1.0/.dockerignore

@@ -0,0 +1,8 @@
+.git
+.gitignore
+.venv
+__pycache__/
+*.pyc
+data/
+README.md
+LICENSE

quantified_self_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,76 @@
+name: Bug Report
+description: Report a reproducible problem with Quantified Self MCP
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug.
+
+        Please do not include real personal health data, credentials, API keys,
+        tokens, or private databases.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Clearly describe the problem.
+      placeholder: Describe the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Tell us how to reproduce the issue.
+      placeholder: |
+        1. Start the server
+        2. Run ...
+        3. Call tool ...
+        4. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: What actually happened?
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Quantified Self MCP version or commit
+      placeholder: e.g. v1.0.0 or commit hash
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: e.g. Python 3.12.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - Linux
+        - macOS
+        - Windows
+        - Other
+    validations:

quantified_self_mcp-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/Thecimal/quantified-self-mcp/security/advisories
+    about: Please report security vulnerabilities privately when private reporting is enabled.

quantified_self_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,56 @@
+name: Feature Request
+description: Suggest an improvement or new capability
+title: "[Feature]: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting an improvement.
+
+        For significant features, please describe the privacy and security implications.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem would this feature solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe the feature you would like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Are there other ways to solve this problem?
+
+  - type: textarea
+    id: privacy
+    attributes:
+      label: Privacy and security considerations
+      description: |
+        Could this feature expose additional personal data, require network access,
+        introduce write access, or affect the local-first architecture?
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Add any other context, examples, or references.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched existing issues and feature requests.
+          required: true

quantified_self_mcp-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,36 @@
+## Summary
+
+Describe what this pull request changes and why.
+
+## Related Issue
+
+Closes #
+
+## Changes
+
+-
+-
+-
+
+## Testing
+
+Describe how you tested these changes.
+
+```text
+Commands run:
+```
+
+## Privacy and Security
+
+Please check all that apply:
+
+- [ ] This change does not introduce unnecessary telemetry or tracking.
+- [ ] This change does not expose additional personal user data.
+- [ ] This change does not introduce unexpected network communication.
+- [ ] This change does not modify user data unexpectedly.
+- [ ] No credentials, tokens, private databases, or personal data are included.
+
+## Documentation
+
+- [ ] Documentation was updated where necessary.
+- [ ] No documentation changes are required.

quantified_self_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -r requirements-dev.txt
+
+      - name: Run test suite
+        run: pytest tests/ -v
+
+      - name: Check server.py syntax
+        run: python -m py_compile server.py && echo "server.py OK"
+
+      - name: Check init_db.py syntax
+        run: python -m py_compile init_db.py && echo "init_db.py OK"
+
+      - name: Test database initialization
+        run: |
+          python init_db.py sample_data/health_sample.csv
+          python -c "
+          import sqlite3
+          conn = sqlite3.connect('data/health.db')
+          count = conn.execute('SELECT COUNT(*) FROM daily_metrics').fetchone()[0]
+          assert count > 0, 'No rows loaded'
+          print(f'health.db OK — {count} rows')
+          "
+
+      - name: Test server imports cleanly
+        run: python -c "import server; print('server imports OK')"

quantified_self_mcp-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+# Personal data — never commit this
+data/
+*.db
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+*.egg-info/
+
+# OS
+.DS_Store
+Thumbs.db

quantified_self_mcp-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,52 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and maintainers pledge to make participation in our
+community a harassment-free experience for everyone, regardless of experience
+level, background, identity, or personal characteristics.
+
+We are committed to fostering an open, welcoming, respectful, and collaborative
+environment.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+
+- Being respectful and constructive in discussions.
+- Welcoming different viewpoints and experiences.
+- Giving and accepting constructive feedback.
+- Focusing on what is best for the project and its community.
+- Showing empathy toward other community members.
+- Respecting the privacy and security principles of the project.
+
+Examples of unacceptable behavior include:
+
+- Harassment, discrimination, or personal attacks.
+- Trolling, insulting, or deliberately disruptive comments.
+- Publishing another person's private information without permission.
+- Sharing sensitive data, credentials, personal health data, or other confidential information.
+- Misrepresenting the project's capabilities or security guarantees.
+- Any other conduct that could reasonably be considered inappropriate in a
+  professional and collaborative environment.
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards
+of acceptable behavior.
+
+Maintainers may remove, edit, or reject comments, commits, code, issues, pull
+requests, or other contributions that do not align with this Code of Conduct.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, including GitHub issues,
+pull requests, discussions, community communication channels, and public
+representation of the project.
+
+## Reporting Issues
+
+If you experience or witness unacceptable behavior, please report it privately
+to the project maintainers.
+
+Please do not post sensitive reports, personal information, credentials, or

quantified_self_mcp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,108 @@
+# Contributing to Quantified Self MCP
+
+Thank you for your interest in contributing to Quantified Self MCP.
+
+This project aims to provide a privacy-first, local MCP server for querying
+personal data through AI assistants while keeping users in control of their data.
+
+We welcome bug reports, documentation improvements, tests, feature ideas, and
+code contributions.
+
+## Before You Start
+
+Before making significant changes:
+
+1. Check existing issues and pull requests.
+2. Open an issue to discuss large features or architectural changes.
+3. Make sure your contribution aligns with the project's privacy-first and
+   local-first principles.
+
+For small fixes, documentation improvements, and test improvements, you can
+usually open a pull request directly.
+
+## Development Setup
+
+Clone the repository:
+
+```bash
+git clone https://github.com/Thecimal/quantified-self-mcp.git
+cd quantified-self-mcp
+```
+
+Create and activate your development environment according to the installation
+instructions in the README.
+
+Install the required dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Run the available tests before submitting changes.
+
+## Project Principles
+
+### Privacy First
+
+Do not introduce unnecessary telemetry, tracking, analytics, or network
+communication.
+
+Personal user data should remain under the user's control.
+
+### Local First
+
+The project should continue to work locally without requiring cloud
+infrastructure unless an optional integration explicitly documents otherwise.
+
+### Security
+
+Do not commit:
+
+- API keys
+- Access tokens
+- Passwords
+- Private keys
+- Personal databases
+- Personal health data
+- Real user datasets
+
+Use synthetic or anonymized sample data for tests and examples.
+
+### Data Safety
+
+Contributors should not introduce unexpected modification of user data.
+
+Any future write functionality should require explicit discussion, documentation,
+and security review.
+
+## Making Changes
+
+1. Fork the repository.
+2. Create a new branch.
+3. Make your changes.
+4. Add or update tests where appropriate.
+5. Update documentation if user-facing behavior changes.
+6. Run the test suite.
+7. Commit your changes with a clear commit message.
+8. Open a pull request.
+
+## Code Quality
+
+Please aim for contributions that are:
+
+- Clear and readable.
+- Focused on a single purpose.
+- Covered by tests when practical.
+- Documented when behavior changes.
+- Compatible with supported Python versions.
+- Consistent with the existing project architecture.
+
+Avoid unrelated refactoring in the same pull request.
+
+## Testing
+
+Before opening a pull request, verify that:
+
+- Existing tests still pass.
+- New functionality is tested when appropriate.
+- Sample data does not contain real private information.

quantified_self_mcp-0.1.0/Dockerfile

@@ -0,0 +1,39 @@
+# Dockerfile for quantified-self-mcp (https://github.com/Thecimal/quantified-self-mcp)
+#
+# This server is Python-only (FastMCP) — there is no server.js / Node.js
+# entrypoint anywhere in this repo. Building from an explicit Python base
+# image here, instead of relying on Glama's generic buildpack, guarantees
+# `python` and `pip` are actually present in the image and that the
+# platform launches `python server.py` (not a Node.js fallback).
+#
+# Build:
+#   docker build -t quantified-self-mcp .
+# Run (stdio MCP server):
+#   docker run -i --rm -v "$PWD/data:/app/data" quantified-self-mcp
+
+FROM python:3.12-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+WORKDIR /app
+
+# Install dependencies first so this layer is cached across source edits.
+COPY requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Application source. init_db.py and sample_data are included so the
+# server can be seeded with example data inside the container.
+COPY server.py init_db.py ./
+COPY sample_data ./sample_data
+
+# health.db / finance.db live here by default (see server.py). Point them
+# at Glama's persistent volume mount (/data) so a redeploy doesn't wipe
+# your data; override with your own path if you're not on Glama.
+ENV HEALTH_DB_PATH=/data/health.db \
+    FINANCE_DB_PATH=/data/finance.db
+
+# Talks to its client over stdio — Glama (and Claude Desktop) wrap stdio
+# servers automatically, so the container just needs to run the process.
+ENTRYPOINT ["python", "server.py"]

quantified_self_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Behnoud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

quantified_self_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.5
+Name: quantified-self-mcp
+Version: 0.1.0
+Summary: Local MCP server for personal health and finance data
+License: MIT License
+        
+        Copyright (c) 2026 Behnoud
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        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 THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: fastmcp<4.0,>=3.0
+Description-Content-Type: text/markdown
+
+# Quantified Self MCP
+
+[![Glama MCP Server](https://glama.ai/mcp/servers/Thecimal/quantified-self-mcp/badge)](https://glama.ai/mcp/servers/Thecimal/quantified-self-mcp)
+
+*Try it Live!*
+
+**A private, local-first MCP server that lets LLMs access your personal health data.**
+
+Quantified Self MCP connects an LLM to health data stored on your computer using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
+
+It is **not limited to Claude**. It can work with local LLMs as well as cloud-based models that support MCP.
+
+## Privacy first
+
+Your health data is stored locally in SQLite, and the MCP server runs entirely on your computer.
+
+```text
+Your Health Data
+      ↓
+ Local SQLite
+      ↓
+  MCP Server
+      ↓
+   LLM
+```
+
+For maximum privacy, use a local LLM so everything stays on your machine.
+
+Cloud LLMs such as Claude can also be used. In that case, your database and MCP server remain local, but the data returned to the model may be sent to the cloud provider.
+
+## Current functionality
+
+The server currently provides three tools:
+
+**`read_health_data`** — read-only
+
+It can access:
+
+* Daily steps
+* Sleep duration
+* Resting heart rate
+* Weight (kg)
+* Workout minutes
+* Mood (1–10 scale)
+* Water intake (ml)
+* Data for a selected date range
+
+Every field is optional per day — log just the metrics you actually track.
+
+**`log_daily_metric`** — write
+
+Lets the LLM record any of the metrics above for a given day, without you touching a CSV or SQLite directly. Pass just the fields you're logging (e.g. only `mood`) and the rest of that day's data is left exactly as it was — nothing is ever cleared, only set. Values are checked against generous sanity bounds before being written (e.g. `mood` 1–10, `resting_heart_rate` 20–250 bpm) — this catches unit mix-ups and typos, not "abnormal" readings. It's a plain per-date upsert into `daily_metrics`; there's no way for it (or anything else in this server) to run arbitrary SQL. The same bounds are applied to CSV imports via `init_db.py`, so a bad value there is skipped with a warning rather than silently loaded.
+
+**`clear_metric`** — write
+
+Blanks out a single metric for a single day, for undoing a bad `log_daily_metric` call (wrong date, wrong units, etc.) without needing to re-run `init_db.py`.
+
+## Installation
+
+```bash
+git clone https://github.com/Thecimal/quantified-self-mcp.git
+cd quantified-self-mcp
+
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+Initialize the database:
+
+```bash
+python init_db.py sample_data/health_sample.csv
+```
+
+CSV columns: `date, steps, sleep_hours, resting_heart_rate` are required;
+`weight_kg, workout_minutes, mood, water_ml` are optional — include any
+subset of them. Re-running `init_db.py` upserts by date, and a CSV that
+omits an optional column leaves that column's existing values alone
+rather than clearing them, so you can add a new metric later without
+disturbing what's already logged. An existing database is migrated
+automatically, so upgrading never requires deleting it.
+
+## Using it with LLMs
+
+Use it with any MCP-compatible client and model.
+
+Examples:
+
+* Local LLMs
+* Claude
+* Other MCP-compatible LLMs
+
+Example:
+
+> How has my sleep changed over the last 30 days?
+
+The LLM retrieves the relevant data through MCP and analyzes it.
+
+## Project structure
+
+```text
+server.py      # MCP server
+logic.py       # Data validation and analysis
+init_db.py     # Database initialization
+sample_data/   # Example health data
+```
+
+## Philosophy
+
+**Your data stays yours.**
+
+Keep your personal data local, give the LLM controlled access, and choose whether the model runs locally or in the cloud.
+
+## License
+
+MIT