mcp-context-server 0.1.0__tar.gz

mcp_context_server-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,49 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+A clear and concise description of what the bug is.
+
+## To Reproduce
+Steps to reproduce the behavior:
+1. Run command '...'
+2. See error
+
+## Expected Behavior
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+What actually happened instead.
+
+## Error Messages
+```text
+Paste any error messages here
+```
+
+## System Information
+ - OS: [e.g., Windows 11, macOS 14, Ubuntu 22.04]
+ - Python Version: [run `python --version`]
+ - uv Version: [run `uv --version`]
+ - MCP Client: [e.g., Claude Code, LangGraph, etc.]
+ - MCP Context Server Version: [from pyproject.toml]
+
+## Diagnostic Output
+Please run and paste output:
+```bash
+# Test if server starts
+uv run python -m app.server
+
+# Check database location
+ls -la ~/.mcp/context_storage.db
+```
+
+## Additional Context
+Add any other context about the problem here.
+
+## Possible Solution
+If you have suggestions on how to fix the issue.

mcp_context_server-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,33 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+A clear and concise description of what you want to happen.
+
+## Problem It Solves
+Describe the problem or limitation this feature would address.
+
+## Proposed Solution
+Describe how you envision this feature working.
+
+## Alternatives Considered
+Describe any alternative solutions or features you've considered.
+
+## Use Cases
+Provide examples of how this feature would be used:
+1.
+2.
+3.
+
+## Additional Context
+Add any other context, mockups, or examples about the feature request here.
+
+## Would you be willing to contribute this feature?
+- [ ] Yes, I can implement this
+- [ ] Yes, I can help test it
+- [ ] No, but I can provide more details if needed

mcp_context_server-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,99 @@
+name: Lint and Validate
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  security-events: write
+
+jobs:
+  pre-commit:
+    name: Run Pre-Commit Checks
+    if: ${{ ! startsWith(github.head_ref, 'release-please--branches--') }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: pyproject.toml
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Install pre-commit
+        run: pip install pre-commit
+
+      - name: Run pre-commit hooks
+        run: |
+          pre-commit run --all-files --show-diff-on-failure
+
+  mcp:
+    name: MCP Checks
+    if: ${{ ! startsWith(github.head_ref, 'release-please--branches--') }}
+    runs-on: ubuntu-latest
+    env:
+      SERVER_NAME: io.github.alex-feel/mcp-context-server
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Verify MCP marker in README
+        run: |
+          set -euo pipefail
+          # Accept either plain line or HTML comment
+          if grep -Eq "(^|<!--[[:space:]]*)mcp-name:[[:space:]]*${SERVER_NAME}([[:space:]]*-->|$)" README.md; then
+            echo 'OK: README contains MCP marker'
+          else
+            echo "README.md must contain 'mcp-name: ${SERVER_NAME}' line or HTML comment" >&2
+            exit 1
+          fi
+
+      - name: Validate server.json presence and JSON syntax
+        run: |
+          python - <<'PY'
+          # Validate that server.json exists and is valid JSON
+          import json, sys
+          from pathlib import Path
+          p = Path('server.json')
+          if not p.exists():
+             print('server.json not found', file=sys.stderr)
+             sys.exit(1)
+          with p.open('r', encoding='utf-8') as f:
+             json.load(f)
+          print('OK: server.json exists and is valid JSON')
+          PY
+
+  security:
+    name: Security Scan
+    if: ${{ ! startsWith(github.head_ref, 'release-please--branches--') }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Run Trivy security scanner
+        uses: aquasecurity/trivy-action@master
+        with:
+          scan-type: 'fs'
+          scan-ref: '.'
+          format: 'sarif'
+          output: 'trivy-results.sarif'
+
+      - name: Upload Trivy results to GitHub Security
+        uses: github/codeql-action/upload-sarif@v3
+        if: always()
+        with:
+          sarif_file: 'trivy-results.sarif'

mcp_context_server-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,149 @@
+name: Build and Publish Application
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build Application
+    runs-on: ubuntu-latest
+    env:
+      SERVER_NAME: io.github.alex-feel/mcp-context-server
+      PACKAGE_NAME: mcp-context-server
+    outputs:
+      dist-path: ${{ steps.build.outputs.dist-path }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: pyproject.toml
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          cache-dependency-glob: 'pyproject.toml'
+
+      - name: Refresh uv.lock for this release
+        run: |
+          set -euo pipefail
+          # Recreate lock so it captures the project version from the tagged commit
+          uv lock
+          test -f uv.lock || { echo 'uv.lock was not created' >&2; exit 1; }
+
+      - name: Assert uv.lock contains the release version
+        run: |
+          set -euo pipefail
+          tag='${{ github.event.release.tag_name }}'
+          version="${tag#v}"   # strip leading 'v' if present
+          # Check that the version string exists in uv.lock
+          if grep -Eq "version\\s*=\\s*\"${version}\"" uv.lock; then
+            echo "OK: uv.lock references version ${version}"
+          else
+            echo "uv.lock does not reference version ${version}" >&2
+            echo 'Dumping first 80 lines for debugging:'
+            head -n 80 uv.lock || true
+            exit 1
+          fi
+
+      - name: Build component
+        id: build
+        run: |
+          uv build
+          echo "dist-path=dist" >> "$GITHUB_OUTPUT"
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dists
+          path: ${{ steps.build.outputs.dist-path }}/
+
+  publish-to-pypi:
+    name: Publish Application to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mcp-context-server/${{ github.event.release.tag_name }}
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dists
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  publish-to-mcp-registry:
+    name: Publish Application to MCP Registry
+    needs: publish-to-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    env:
+      SERVER_NAME: io.github.alex-feel/mcp-context-server
+      PACKAGE_NAME: mcp-context-server
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Install tools
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y jq
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.22'
+
+      - name: Build mcp-publisher from source
+        run: |
+          set -eux
+          git clone https://github.com/modelcontextprotocol/registry mcp-registry
+          cd mcp-registry
+          go build -o ../mcp-publisher ./cmd/publisher
+          cd ..
+          ./mcp-publisher --help
+
+      - name: Wait for PyPI to serve this release
+        run: |
+          set -euo pipefail
+          tag='${{ github.event.release.tag_name }}'
+          version="${tag#v}"  # срезаем префикс v, если есть
+          for i in {1..30}; do
+            if curl -sf https://pypi.org/pypi/${PACKAGE_NAME}/json | jq -e --arg v "$version" '.releases[$v]'; then
+              echo "PyPI has version $version"
+              exit 0
+            fi
+            echo "Waiting for PyPI to serve $version, attempt $i"
+            sleep 10
+          done
+          echo "Version $version not visible on PyPI yet"
+          exit 1
+
+      - name: Login to MCP Registry using GitHub OIDC
+        run: ./mcp-publisher login github-oidc
+
+      - name: Publish to MCP Registry
+        run: ./mcp-publisher publish --file server.json
+
+      - name: Verify in MCP Registry
+        run: |
+          curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=${SERVER_NAME}" | jq .

mcp_context_server-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,57 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    name: Release Please
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  update-uv-lock:
+    name: Update uv.lock file
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: pyproject.toml
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Update uv.lock file
+        run: uv lock
+
+      - name: Commit and push updated uv.lock
+        run: |
+          git config --global user.name "GitHub Actions Bot"
+          git config --global user.email "actions@github.com"
+          git add uv.lock
+          git commit -m "chore: update uv.lock after version bump [skip ci]" || echo "No changes to commit"
+          git remote set-url origin https://x-access-token:${{ secrets.RELEASE_PLEASE_TOKEN }}@github.com/${GITHUB_REPOSITORY}
+          git push

mcp_context_server-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,86 @@
+name: Test & Coverage
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  checks: write
+  pull-requests: write
+
+jobs:
+  test:
+    name: Test
+    if: ${{ ! startsWith(github.head_ref, 'release-please--branches--') }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: pyproject.toml
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run pytest with coverage
+        run: uv run pytest -v --cov=app --cov-report=term-missing --cov-report=xml --cov-report=html --junit-xml=test-results.xml tests/
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: test-results.xml
+
+      - name: Upload coverage reports
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: |
+            coverage.xml
+            htmlcov/
+
+      - name: Surface test results
+        if: always()
+        uses: pmeier/pytest-results-action@main
+        with:
+          path: test-results.xml
+          summary: true
+          display-options: fEX
+          fail-on-empty: true
+
+      - name: Coverage comment
+        if: github.event_name == 'pull_request'
+        uses: py-cov-action/python-coverage-comment-action@v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          MINIMUM_GREEN: 80
+          MINIMUM_ORANGE: 60
+
+  # Summary job
+  summary:
+    name: Test Summary
+    runs-on: ubuntu-latest
+    needs: [test]
+    if: ${{ always() && ! startsWith(github.head_ref, 'release-please--branches--') }}
+
+    steps:
+      - name: Summary
+        run: |
+          echo "## Test Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "✅ All tests completed successfully!" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Platform" >> $GITHUB_STEP_SUMMARY
+          echo "- ✅ Ubuntu" >> $GITHUB_STEP_SUMMARY

mcp_context_server-0.1.0/.gitignore

@@ -0,0 +1,162 @@
+### IDE
+.idea
+.claude
+
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Linting
+.ruff_cache/
+
+# Unit / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+report.xml
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/

mcp_context_server-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,59 @@
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.13.1
+  hooks:
+    - id: ruff-check
+      name: Ruff (lint + autofix)
+      description: Fast Python linter (Flake8, isort, quotes, etc.) with --fix enabled
+      args: [--fix, .]
+      pass_filenames: false
+      always_run: true
+
+- repo: local
+  hooks:
+    - id: mypy
+      name: Mypy (uv)
+      language: system
+      entry: uv
+      args: ['run', '--frozen', '--group', 'dev', '--', 'mypy', '--config-file=pyproject.toml']
+      pass_filenames: false
+      always_run: true
+      types_or: [python, pyi]
+
+- repo: local
+  hooks:
+    - id: pyright
+      name: Pyright (uv)
+      language: system
+      entry: uv
+      args: ['run', '--frozen', '--group', 'dev', '--', 'pyright']
+      pass_filenames: false
+      always_run: true
+
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v6.0.0
+  hooks:
+    - id: end-of-file-fixer
+      name: End-of-file fixer (non-Python)
+      description: Ensures every *non-Python* file is empty or ends with a single newline
+      exclude: ^.*\.(json|pyi?|py)$
+
+    - id: trailing-whitespace
+      name: Trailing-whitespace (non-Python)
+      description: Trims trailing whitespace in non-Python text files
+      exclude: ^.*\.(pyi?|py)$
+
+    - id: check-shebang-scripts-are-executable
+      name: Check shebang scripts
+      description: Check that text files with a shebang are executable
+
+- repo: https://github.com/astral-sh/uv-pre-commit
+  rev: 0.8.19
+  hooks:
+    - id: uv-lock
+      name: Make sure uv.lock file is up to date
+
+- repo: https://github.com/commitizen-tools/commitizen
+  rev: v4.9.1
+  hooks:
+    - id: commitizen

mcp_context_server-0.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}