people-context-mcp 0.1.0__tar.gz

people_context_mcp-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,36 @@
+{
+  "name": "people-context-plugins",
+  "owner": {
+    "name": "Jinyang Wang"
+  },
+  "description": "Local-first Claude Code integrations for people-context-mcp.",
+  "plugins": [
+    {
+      "name": "people-context",
+      "displayName": "People Context",
+      "version": "0.1.0",
+      "source": ".",
+      "description": "Give Claude Code local, durable context about the people in your life through an automatically managed stdio MCP server.",
+      "author": {
+        "name": "Jinyang Wang"
+      },
+      "homepage": "https://github.com/JinyangWang27/people-context-mcp/blob/main/docs/claude-code-plugin.md",
+      "repository": "https://github.com/JinyangWang27/people-context-mcp",
+      "license": "MIT",
+      "keywords": [
+        "mcp",
+        "people",
+        "context",
+        "memory",
+        "local-first"
+      ],
+      "category": "productivity",
+      "tags": [
+        "mcp",
+        "personal-knowledge",
+        "local-first"
+      ],
+      "strict": true
+    }
+  ]
+}

people_context_mcp-0.1.0/.claude-plugin/mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "people-context": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "--project",
+        "${CLAUDE_PLUGIN_ROOT}",
+        "people-context-mcp"
+      ]
+    }
+  }
+}

people_context_mcp-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "people-context",
+  "displayName": "People Context",
+  "version": "0.1.0",
+  "description": "Give Claude Code local, durable context about the people in your life through people-context-mcp.",
+  "author": {
+    "name": "Jinyang Wang",
+    "url": "https://github.com/JinyangWang27"
+  },
+  "homepage": "https://github.com/JinyangWang27/people-context-mcp/blob/main/docs/claude-code-plugin.md",
+  "repository": "https://github.com/JinyangWang27/people-context-mcp",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "people",
+    "context",
+    "memory",
+    "local-first"
+  ],
+  "mcpServers": "./mcp.json"
+}

people_context_mcp-0.1.0/.codegraph/.gitignore

@@ -0,0 +1,16 @@
+# CodeGraph data files
+# These are local to each machine and should not be committed
+
+# Database
+*.db
+*.db-wal
+*.db-shm
+
+# Cache
+cache/
+
+# Logs
+*.log
+
+# Hook markers
+.dirty

people_context_mcp-0.1.0/.codegraph/config.json

@@ -0,0 +1,143 @@
+{
+  "version": 1,
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.js",
+    "**/*.jsx",
+    "**/*.py",
+    "**/*.go",
+    "**/*.rs",
+    "**/*.java",
+    "**/*.c",
+    "**/*.h",
+    "**/*.cpp",
+    "**/*.hpp",
+    "**/*.cc",
+    "**/*.cxx",
+    "**/*.cs",
+    "**/*.php",
+    "**/*.rb",
+    "**/*.swift",
+    "**/*.kt",
+    "**/*.kts",
+    "**/*.dart",
+    "**/*.svelte",
+    "**/*.vue",
+    "**/*.liquid",
+    "**/*.pas",
+    "**/*.dpr",
+    "**/*.dpk",
+    "**/*.lpr",
+    "**/*.dfm",
+    "**/*.fmx",
+    "**/*.scala",
+    "**/*.sc"
+  ],
+  "exclude": [
+    "**/.git/**",
+    "**/node_modules/**",
+    "**/vendor/**",
+    "**/Pods/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/bin/**",
+    "**/obj/**",
+    "**/target/**",
+    "**/*.min.js",
+    "**/*.bundle.js",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.svelte-kit/**",
+    "**/.output/**",
+    "**/.turbo/**",
+    "**/.cache/**",
+    "**/.parcel-cache/**",
+    "**/.vite/**",
+    "**/.astro/**",
+    "**/.docusaurus/**",
+    "**/.gatsby/**",
+    "**/.webpack/**",
+    "**/.nx/**",
+    "**/.yarn/cache/**",
+    "**/.pnpm-store/**",
+    "**/storybook-static/**",
+    "**/.expo/**",
+    "**/web-build/**",
+    "**/ios/Pods/**",
+    "**/ios/build/**",
+    "**/android/build/**",
+    "**/android/.gradle/**",
+    "**/__pycache__/**",
+    "**/.venv/**",
+    "**/venv/**",
+    "**/site-packages/**",
+    "**/dist-packages/**",
+    "**/.pytest_cache/**",
+    "**/.mypy_cache/**",
+    "**/.ruff_cache/**",
+    "**/.tox/**",
+    "**/.nox/**",
+    "**/*.egg-info/**",
+    "**/.eggs/**",
+    "**/go/pkg/mod/**",
+    "**/target/debug/**",
+    "**/target/release/**",
+    "**/.gradle/**",
+    "**/.m2/**",
+    "**/generated-sources/**",
+    "**/.kotlin/**",
+    "**/.dart_tool/**",
+    "**/.vs/**",
+    "**/.nuget/**",
+    "**/artifacts/**",
+    "**/publish/**",
+    "**/cmake-build-*/**",
+    "**/CMakeFiles/**",
+    "**/bazel-*/**",
+    "**/vcpkg_installed/**",
+    "**/.conan/**",
+    "**/Debug/**",
+    "**/Release/**",
+    "**/x64/**",
+    "**/.pio/**",
+    "**/release/**",
+    "**/*.app/**",
+    "**/*.asar",
+    "**/DerivedData/**",
+    "**/.build/**",
+    "**/.swiftpm/**",
+    "**/xcuserdata/**",
+    "**/Carthage/Build/**",
+    "**/SourcePackages/**",
+    "**/__history/**",
+    "**/__recovery/**",
+    "**/*.dcu",
+    "**/.composer/**",
+    "**/storage/framework/**",
+    "**/bootstrap/cache/**",
+    "**/.bundle/**",
+    "**/tmp/cache/**",
+    "**/public/assets/**",
+    "**/public/packs/**",
+    "**/.yardoc/**",
+    "**/coverage/**",
+    "**/htmlcov/**",
+    "**/.nyc_output/**",
+    "**/test-results/**",
+    "**/.coverage/**",
+    "**/.idea/**",
+    "**/logs/**",
+    "**/tmp/**",
+    "**/temp/**",
+    "**/_build/**",
+    "**/docs/_build/**",
+    "**/site/**"
+  ],
+  "languages": [],
+  "frameworks": [],
+  "maxFileSize": 1048576,
+  "extractDocstrings": true,
+  "trackCallSites": true
+}

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

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v6
+      - run: uv sync --all-extras
+      - run: uv run ruff check .
+      - name: Run tests with coverage
+        run: uv run --with pytest-cov pytest --cov=people_context --cov-report=xml -q
+      - name: Upload coverage to Codecov
+        if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
+        uses: codecov/codecov-action@v6
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}

people_context_mcp-0.1.0/.github/workflows/claude-plugin-validate.yml

@@ -0,0 +1,56 @@
+name: Validate Claude Code plugin
+
+on:
+  pull_request:
+    paths:
+      - ".claude-plugin/**"
+      - "docs/claude-code-plugin.md"
+      - ".github/workflows/claude-plugin-validate.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "src/**"
+      - "tests/adapters/test_mcp_server.py"
+      - "tests/adapters/test_email_import.py"
+  push:
+    branches:
+      - main
+    paths:
+      - ".claude-plugin/**"
+      - "docs/claude-code-plugin.md"
+      - ".github/workflows/claude-plugin-validate.yml"
+      - "pyproject.toml"
+      - "uv.lock"
+      - "src/**"
+      - "tests/adapters/test_mcp_server.py"
+      - "tests/adapters/test_email_import.py"
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+
+      - name: Install Claude Code
+        run: npm install --global @anthropic-ai/claude-code@latest
+
+      - name: Validate marketplace and plugin
+        run: claude plugin validate . --strict
+
+      - uses: astral-sh/setup-uv@v7
+
+      - name: Verify local MCP entry point
+        run: uv run --locked people-context-mcp --help
+
+      - name: Verify security boundaries
+        run: >-
+          uv run --locked pytest -q
+          tests/adapters/test_mcp_server.py
+          tests/adapters/test_email_import.py

people_context_mcp-0.1.0/.github/workflows/package-publish.yml

@@ -0,0 +1,67 @@
+name: Publish OpenClaw plugin
+
+on:
+  pull_request:
+    paths:
+      - "openclaw-plugin/**"
+      - ".github/workflows/package-publish.yml"
+  workflow_dispatch:
+
+jobs:
+  verify-dist:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    defaults:
+      run:
+        working-directory: ./openclaw-plugin
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+
+      - name: Install dependencies
+        run: npm ci --no-audit --no-fund
+
+      - name: Rebuild dist
+        run: npm run build
+
+      - name: Fail if committed dist is stale
+        run: |
+          if ! git diff --quiet -- dist; then
+            echo "::error::Committed openclaw-plugin/dist is out of sync with src. Run 'npm run build' and commit the result."
+            git --no-pager diff --stat -- dist
+            exit 1
+          fi
+
+      - name: Run plugin tests
+        run: npm test
+
+  dry-run:
+    if: github.event_name == 'pull_request'
+    permissions:
+      contents: read
+      id-token: write
+    # Pinned to the v0.12.0 commit SHA (mutable tags can be re-pointed at malicious code).
+    uses: openclaw/clawhub/.github/workflows/package-publish.yml@ecf09b868a986751137f4272283f84967a16c765
+    with:
+      source: ./openclaw-plugin
+      owner: jinyangwang27
+      dry_run: true
+
+  publish:
+    if: github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: read
+      id-token: write
+    # Pinned to the v0.12.0 commit SHA (mutable tags can be re-pointed at malicious code).
+    uses: openclaw/clawhub/.github/workflows/package-publish.yml@ecf09b868a986751137f4272283f84967a16c765
+    with:
+      source: ./openclaw-plugin
+      owner: jinyangwang27
+      dry_run: false
+    secrets:
+      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

people_context_mcp-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,47 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v6
+      - name: Build wheel and source distribution
+        run: uv build
+      - name: Verify distribution metadata
+        run: uvx twine check dist/*
+      - name: Store distributions
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish distribution to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/people-context-mcp
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

people_context_mcp-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+dist/
+!openclaw-plugin/dist/
+!openclaw-plugin/dist/**
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Node
+node_modules/
+
+# Data (local SQLite store — never commit user data)
+*.db
+*.db-wal
+*.db-shm
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/
+
+tmp/

people_context_mcp-0.1.0/AGENTS.md

@@ -0,0 +1,39 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+Application code lives under `src/people_context/` and follows a hexagonal architecture:
+
+- `domain/` contains Pydantic entities and dependency-free business rules.
+- `app/` contains one use case per module and depends only on `domain/` and narrow protocols in `ports/`.
+- `adapters/` contains SQLite persistence, MCP transports/tools, importers, and optional semantic integrations.
+- `cli.py`, `config.py`, and `adapters/mcp/server.py` are composition and process-boundary entry points.
+
+Tests mirror these layers under `tests/domain/`, `tests/app/`, and `tests/adapters/`. Design documentation, interface contracts, privacy rules, and ADRs live in `docs/`.
+
+## Build, Test, and Development Commands
+
+- `uv sync` installs the project and development dependencies.
+- `uv sync --extra semantic` explicitly installs optional Model2Vec and sqlite-vec support.
+- `uv run people-context-mcp` starts the default stdio MCP server.
+- `uv run people-context-mcp --http --host 127.0.0.1 --port 8765` starts loopback HTTP.
+- `uv run people-context db-path` shows the active SQLite database.
+- `uv run pytest -q` runs the complete test suite.
+- `uv run ruff check .` checks formatting-independent style and imports.
+- `uv build` creates source and wheel distributions.
+
+## Coding Style & Naming Conventions
+
+Use four-space indentation, complete type hints, and a 120-character line limit. Ruff enforces `E`, `F`, `I`, `UP`, `B`, and `SIM` rules. Name modules and functions with `snake_case`, classes with `PascalCase`, and constants with `UPPER_CASE`. Keep functions focused and prefer explicit dependency injection through `typing.Protocol` ports. Never import `adapters`, `mcp`, or `sqlite3` from `domain/` or `app/`.
+
+## Testing Guidelines
+
+Use pytest and name files `test_<subject>.py` and tests `test_<behavior>()`. Test application policy against in-memory fakes in `tests/app/fakes.py`; test persistence and transport behavior separately with SQLite and subprocess/E2E tests. Add a regression test for every bug and run focused tests before the full suite.
+
+## Commit & Pull Request Guidelines
+
+Use concise imperative Conventional Commit subjects, matching history: `feat: add ...`, `fix: report ...`, or `docs: mark ...`. Keep commits green and narrowly scoped. Pull requests should explain behavior and privacy impact, list verification commands, link relevant issues, and update interface or architecture documentation when contracts change.
+
+## Security & Configuration
+
+This repository stores sensitive personal data locally. Never persist raw import content or log private values. Keep HTTP loopback-only and unauthenticated; remote access is out of scope. Ordinary commands must not access the network—only explicit `people-context reindex --semantic` may download the pinned model.

people_context_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jinyang Wang
+
+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.