diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 00000000..cf01b654 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,253 @@ +{ + "name": "clio-kit", + "owner": { + "name": "IoWarp Team - Gnosis Research Center", + "email": "grc@illinoistech.edu" + }, + "metadata": { + "description": "CLIO Kit - MCP Servers for Scientific Computing and HPC", + "version": "1.0.0", + "pluginRoot": "./clio-kit-mcp-servers" + }, + "plugins": [ + { + "name": "clio-adios", + "source": "./clio-kit-mcp-servers/adios", + "description": "Fetch and analyze BP5 data files using ADIOS2. Access scientific data, metadata, and attributes for research and analysis purposes.", + "version": "1.0.0", + "category": "development", + "keywords": [ + "scientific-computing", + "adios2", + "bp5", + "data-io", + "hpc" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-arxiv", + "source": "./clio-kit-mcp-servers/arxiv", + "description": "ArXiv MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "category": "development", + "keywords": [ + "research", + "arxiv", + "papers", + "literature-search" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-chronolog", + "source": "./clio-kit-mcp-servers/chronolog", + "description": "ChronoLog MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "category": "development", + "keywords": [ + "logging", + "distributed-systems", + "hpc", + "time-series" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-compression", + "source": "./clio-kit-mcp-servers/compression", + "description": "Compression MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "category": "development", + "keywords": [ + "compression", + "gzip", + "file-operations", + "data-management" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-darshan", + "source": "./clio-kit-mcp-servers/darshan", + "description": "Darshan I/O profiler MCP server for analyzing I/O trace files", + "version": "1.0.0", + "category": "development", + "keywords": [ + "io-profiling", + "performance-analysis", + "hpc", + "darshan" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-hdf5", + "source": "./clio-kit-mcp-servers/hdf5", + "description": "HDF5 FastMCP - Scientific Data Access for AI Agents | CLIO Kit MCP Server", + "version": "1.0.0", + "category": "development", + "keywords": [ + "scientific-computing", + "hdf5", + "data-analysis", + "hierarchical-data" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-jarvis", + "source": "./clio-kit-mcp-servers/jarvis", + "description": "Jarvis-CD MCP - Pipeline Management for High-Performance Computing with comprehensive workflow operations", + "version": "1.0.0", + "category": "development", + "keywords": [ + "pipeline-management", + "hpc", + "workflow-automation" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-lmod", + "source": "./clio-kit-mcp-servers/lmod", + "description": "Lmod MCP - Environment Module Management for LLMs with comprehensive module operations", + "version": "1.0.0", + "category": "development", + "keywords": [ + "environment-modules", + "hpc", + "lmod", + "system-administration" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-ndp", + "source": "./clio-kit-mcp-servers/ndp", + "description": "National Data Platform (NDP) MCP server for searching and discovering datasets across multiple CKAN instances", + "version": "1.0.0", + "category": "development", + "keywords": [ + "datasets", + "ckan", + "national-data-platform", + "data-discovery" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-node-hardware", + "source": "./clio-kit-mcp-servers/node-hardware", + "description": "Node Hardware MCP - Comprehensive Hardware Monitoring and System Analysis for LLMs with real-time performance metrics", + "version": "1.0.0", + "category": "development", + "keywords": [ + "hardware-monitoring", + "system-info", + "performance" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-pandas", + "source": "./clio-kit-mcp-servers/pandas", + "description": "Pandas MCP - Advanced Data Analysis for LLMs with comprehensive pandas operations", + "version": "1.0.0", + "category": "development", + "keywords": [ + "data-analysis", + "pandas", + "dataframes", + "statistics" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-parallel-sort", + "source": "./clio-kit-mcp-servers/parallel-sort", + "description": "Parallel Sort MCP - High-Performance Log File Processing for LLMs with advanced sorting and analysis", + "version": "1.0.0", + "category": "development", + "keywords": [ + "log-processing", + "sorting", + "large-files", + "hpc" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-paraview", + "source": "./clio-kit-mcp-servers/paraview", + "description": "MCP server for ParaView scientific visualization", + "version": "1.0.0", + "category": "development", + "keywords": [ + "scientific-visualization", + "paraview", + "3d-rendering", + "hpc" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-parquet", + "source": "./clio-kit-mcp-servers/parquet", + "description": "MCP server for Apache Parquet files", + "version": "1.0.0", + "category": "development", + "keywords": [ + "parquet", + "apache-arrow", + "columnar-data", + "data-analysis" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-plot", + "source": "./clio-kit-mcp-servers/plot", + "description": "MCP server for advanced data visualization and plotting operations", + "version": "1.0.0", + "category": "development", + "keywords": [ + "data-visualization", + "matplotlib", + "plotting", + "charts" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + }, + { + "name": "clio-slurm", + "source": "./clio-kit-mcp-servers/slurm", + "description": "MCP server for Slurm workload management and HPC job scheduling", + "version": "1.0.0", + "category": "development", + "keywords": [ + "hpc", + "slurm", + "job-scheduling", + "cluster-management" + ], + "license": "BSD-3-Clause", + "repository": "https://github.com/iowarp/clio-kit" + } + ] +} diff --git a/.codecov.yml b/.codecov.yml index 02b7a62f..6acc73d2 100644 --- a/.codecov.yml +++ b/.codecov.yml @@ -1,4 +1,4 @@ -# Codecov configuration for Agent Toolkit monorepo +# Codecov configuration for CLIO Kit monorepo # Handles coverage from multiple independent MCP server packages coverage: @@ -11,6 +11,7 @@ coverage: flags: - adios - arxiv + - chronolog - compression - darshan - hdf5 @@ -20,6 +21,7 @@ coverage: - node-hardware - pandas - parallel-sort + - paraview - parquet - plot - slurm @@ -32,46 +34,52 @@ coverage: flags: adios: paths: - - agent-toolkit-mcp-servers/adios/ + - clio-kit-mcp-servers/adios/ arxiv: paths: - - agent-toolkit-mcp-servers/arxiv/ + - clio-kit-mcp-servers/arxiv/ + chronolog: + paths: + - clio-kit-mcp-servers/chronolog/ compression: paths: - - agent-toolkit-mcp-servers/compression/ + - clio-kit-mcp-servers/compression/ darshan: paths: - - agent-toolkit-mcp-servers/darshan/ + - clio-kit-mcp-servers/darshan/ hdf5: paths: - - agent-toolkit-mcp-servers/hdf5/ + - clio-kit-mcp-servers/hdf5/ jarvis: paths: - - agent-toolkit-mcp-servers/jarvis/ + - clio-kit-mcp-servers/jarvis/ lmod: paths: - - agent-toolkit-mcp-servers/lmod/ + - clio-kit-mcp-servers/lmod/ ndp: paths: - - agent-toolkit-mcp-servers/ndp/ + - clio-kit-mcp-servers/ndp/ node-hardware: paths: - - agent-toolkit-mcp-servers/node-hardware/ + - clio-kit-mcp-servers/node-hardware/ pandas: paths: - - agent-toolkit-mcp-servers/pandas/ + - clio-kit-mcp-servers/pandas/ parallel-sort: paths: - - agent-toolkit-mcp-servers/parallel-sort/ + - clio-kit-mcp-servers/parallel-sort/ + paraview: + paths: + - clio-kit-mcp-servers/paraview/ parquet: paths: - - agent-toolkit-mcp-servers/parquet/ + - clio-kit-mcp-servers/parquet/ plot: paths: - - agent-toolkit-mcp-servers/plot/ + - clio-kit-mcp-servers/plot/ slurm: paths: - - agent-toolkit-mcp-servers/slurm/ + - clio-kit-mcp-servers/slurm/ # Comment configuration comment: @@ -87,4 +95,4 @@ ignore: - "**/tests/" - "**/.venv" - "**/htmlcov" - - "agent-toolkit-website/" + - "clio-kit-website/" diff --git a/.github/actions/setup-mcp/action.yml b/.github/actions/setup-mcp/action.yml new file mode 100644 index 00000000..c6d09a42 --- /dev/null +++ b/.github/actions/setup-mcp/action.yml @@ -0,0 +1,34 @@ +name: Setup MCP Server +description: Install uv, Python, and dependencies for an MCP server + +inputs: + python-version: + description: Python version to install + default: "3.12" + mcp: + description: MCP server directory name (under clio-kit-mcp-servers/) + required: true + dev-packages: + description: Space-separated extra dev packages to install + default: "" + +runs: + using: composite + steps: + - name: Install uv + uses: astral-sh/setup-uv@v3 + with: + version: "latest" + + - name: Set up Python ${{ inputs.python-version }} + shell: bash + run: uv python install ${{ inputs.python-version }} + + - name: Install dependencies for ${{ inputs.mcp }} + shell: bash + run: | + cd clio-kit-mcp-servers/${{ inputs.mcp }} + uv sync --all-extras --dev + if [ -n "${{ inputs.dev-packages }}" ]; then + uv add --dev ${{ inputs.dev-packages }} + fi diff --git a/.github/workflows/docs-and-website.yml b/.github/workflows/docs-and-website.yml index 227b0e6e..b59123d1 100644 --- a/.github/workflows/docs-and-website.yml +++ b/.github/workflows/docs-and-website.yml @@ -6,14 +6,14 @@ on: paths: - 'clio-kit-website/**' - 'clio-kit-mcp-servers/**' - - 'scripts/generate_docs.py' + - 'scripts/**' - '.github/workflows/docs-and-website.yml' pull_request: branches: [main, dev] paths: - 'clio-kit-website/**' - 'clio-kit-mcp-servers/**' - - 'scripts/generate_docs.py' + - 'scripts/**' - '.github/workflows/docs-and-website.yml' permissions: @@ -42,19 +42,28 @@ jobs: - name: Install uv uses: astral-sh/setup-uv@v3 - - name: Install Python dependencies + - name: Install root dependencies run: | if [ -f pyproject.toml ]; then uv sync fi - # Update README files (for PRs to dev branch) + - name: Pre-sync MCP server environments + run: | + for dir in clio-kit-mcp-servers/*/; do + if [ -f "$dir/pyproject.toml" ]; then + echo "Syncing $(basename $dir)..." + (cd "$dir" && uv sync --all-extras --dev) || echo "Warning: sync failed for $(basename $dir)" + fi + done + + # Update README files (for PRs to main branch) - name: Update MCP README files - if: github.event_name == 'pull_request' && github.base_ref == 'dev' + if: github.event_name == 'pull_request' && github.base_ref == 'main' run: python3 scripts/readme_filler.py clio-kit-mcp-servers - name: Commit README updates - if: github.event_name == 'pull_request' && github.base_ref == 'dev' + if: github.event_name == 'pull_request' && github.base_ref == 'main' run: | git config --local user.email "github-actions[bot]@users.noreply.github.com" git config --local user.name "github-actions[bot]" @@ -101,7 +110,7 @@ jobs: echo "## Documentation Build Summary" >> $GITHUB_STEP_SUMMARY echo "- ✅ Generated Docusaurus documentation" >> $GITHUB_STEP_SUMMARY echo "- ✅ Built website successfully" >> $GITHUB_STEP_SUMMARY - if [ "${{ github.event_name }}" = "pull_request" ] && [ "${{ github.base_ref }}" = "dev" ]; then + if [ "${{ github.event_name }}" = "pull_request" ] && [ "${{ github.base_ref }}" = "main" ]; then echo "- 📝 Updated README files" >> $GITHUB_STEP_SUMMARY fi if [ "${{ github.ref }}" = "refs/heads/main" ] && [ "${{ github.event_name }}" = "push" ]; then diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index cda22081..045f8cdf 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -155,4 +155,77 @@ jobs: gh release upload '${{ github.ref_name }}' dist/** - --repo '${{ github.repository }}' \ No newline at end of file + --repo '${{ github.repository }}' + + publish-to-mcp-registry: + name: Publish to MCP Registry + needs: + - publish-to-pypi + runs-on: ubuntu-latest + if: startsWith(github.ref, 'refs/tags/') + permissions: + id-token: write # GitHub OIDC for registry authentication + + steps: + - uses: actions/checkout@v4 + + - name: Install mcp-publisher + run: | + brew install mcp-publisher || { + # Fallback: download binary from GitHub releases + curl -fsSL -o /tmp/mcp-publisher \ + "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher-linux-amd64" + chmod +x /tmp/mcp-publisher + sudo mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher + } + mcp-publisher --version + + - name: Authenticate with GitHub OIDC + run: mcp-publisher login github + + - name: Publish each server to MCP registry + run: | + for server_json in clio-kit-mcp-servers/*/server.json; do + server_name=$(basename "$(dirname "$server_json")") + echo "Publishing $server_name to MCP registry..." + mcp-publisher publish --manifest "$server_json" || { + echo "Warning: failed to publish $server_name" + continue + } + echo "Published $server_name" + done + + publish-to-smithery: + name: Publish to Smithery + needs: + - publish-to-pypi + runs-on: ubuntu-latest + if: startsWith(github.ref, 'refs/tags/') + + steps: + - uses: actions/checkout@v4 + + - name: Set up Node.js + uses: actions/setup-node@v4 + with: + node-version: '20' + + - name: Install Smithery CLI + run: npm install -g @smithery/cli + + - name: Publish each server to Smithery + env: + SMITHERY_TOKEN: ${{ secrets.SMITHERY_TOKEN }} + run: | + for server_json in clio-kit-mcp-servers/*/server.json; do + server_dir=$(dirname "$server_json") + server_name=$(basename "$server_dir") + echo "Publishing $server_name to Smithery..." + smithery mcp publish "${{ github.repository }}" \ + -n "iowarp/${server_name}-mcp" \ + --config "$server_json" || { + echo "Warning: failed to publish $server_name to Smithery" + continue + } + echo "Published $server_name to Smithery" + done \ No newline at end of file diff --git a/.github/workflows/quality_control.yml b/.github/workflows/quality_control.yml index 38dd37c8..dcd4ec4d 100644 --- a/.github/workflows/quality_control.yml +++ b/.github/workflows/quality_control.yml @@ -2,9 +2,9 @@ name: Quality Control on: push: - branches: [ main, dev, integration-cleanup, update-workflow-with-correct-code-security ] + branches: [ main, dev ] pull_request: - branches: [ main, dev, integration-cleanup, update-workflow-with-correct-code-security ] + branches: [ main, dev ] # Chronolog MCP tests are handled in dedicated workflow @@ -16,7 +16,7 @@ jobs: mcps: ${{ steps.discover.outputs.mcps }} steps: - uses: actions/checkout@v4 - + - name: Discover MCP directories id: discover run: | @@ -37,7 +37,6 @@ jobs: name: Ruff - ${{ matrix.mcp }} runs-on: ubuntu-latest needs: discover-mcps - continue-on-error: true # Don't fail workflow on linting errors strategy: fail-fast: false matrix: @@ -48,21 +47,10 @@ jobs: with: submodules: 'recursive' - - name: Install uv - uses: astral-sh/setup-uv@v3 + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.12 - run: uv python install 3.12 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev ruff + mcp: ${{ matrix.mcp }} + dev-packages: ruff - name: Run Ruff linter on ${{ matrix.mcp }} run: | @@ -72,7 +60,7 @@ jobs: - name: Run Ruff formatter check on ${{ matrix.mcp }} run: | cd clio-kit-mcp-servers/${{ matrix.mcp }} - uv run ruff format --check . + uv run ruff format --check . mypy: name: MyPy - ${{ matrix.mcp }} @@ -89,21 +77,10 @@ jobs: with: submodules: 'recursive' - - name: Install uv - uses: astral-sh/setup-uv@v3 + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.12 - run: uv python install 3.12 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev mypy + mcp: ${{ matrix.mcp }} + dev-packages: mypy - name: Run MyPy on ${{ matrix.mcp }} run: | @@ -115,48 +92,41 @@ jobs: fi test: - name: Test - ${{ matrix.mcp }} + name: Test - ${{ matrix.mcp }} (py${{ matrix.python-version }}) runs-on: ubuntu-latest needs: discover-mcps - continue-on-error: true # Don't fail workflow on test failures + continue-on-error: ${{ matrix.python-version != '3.12' }} strategy: fail-fast: false matrix: + python-version: ["3.10", "3.11", "3.12"] mcp: ${{ fromJson(needs.discover-mcps.outputs.mcps) }} max-parallel: 20 steps: - uses: actions/checkout@v4 with: submodules: 'recursive' - - - name: Install uv - uses: astral-sh/setup-uv@v3 + + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.12 - run: uv python install 3.12 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev pytest pytest-cov + python-version: ${{ matrix.python-version }} + mcp: ${{ matrix.mcp }} + dev-packages: "pytest pytest-cov" - - name: Run tests with coverage for ${{ matrix.mcp }} + - name: Run tests for ${{ matrix.mcp }} run: | cd clio-kit-mcp-servers/${{ matrix.mcp }} if [ -d tests ]; then - uv run pytest tests/ -v --tb=short --cov=src --cov-report=xml --cov-report=html --cov-report=term --junitxml=junit.xml -o junit_family=legacy + uv run pytest tests/ -v --tb=short \ + --cov=src --cov-report=xml --cov-report=html --cov-report=term \ + --junitxml=junit.xml -o junit_family=legacy else echo "No tests directory found for ${{ matrix.mcp }}" fi - name: Upload coverage to Codecov + if: matrix.python-version == '3.12' && hashFiles('clio-kit-mcp-servers/${{ matrix.mcp }}/coverage.xml') != '' uses: codecov/codecov-action@v4 - if: hashFiles('clio-kit-mcp-servers/${{ matrix.mcp }}/coverage.xml') != '' with: file: clio-kit-mcp-servers/${{ matrix.mcp }}/coverage.xml flags: ${{ matrix.mcp }} @@ -165,15 +135,15 @@ jobs: token: ${{ secrets.CODECOV_TOKEN }} - name: Upload test results to Codecov - if: ${{ !cancelled() }} + if: matrix.python-version == '3.12' && !cancelled() uses: codecov/test-results-action@v1 with: file: clio-kit-mcp-servers/${{ matrix.mcp }}/junit.xml token: ${{ secrets.CODECOV_TOKEN }} - name: Upload coverage HTML report + if: matrix.python-version == '3.12' && hashFiles('clio-kit-mcp-servers/${{ matrix.mcp }}/htmlcov/') != '' uses: actions/upload-artifact@v4 - if: hashFiles('clio-kit-mcp-servers/${{ matrix.mcp }}/htmlcov/') != '' with: name: coverage-html-${{ matrix.mcp }} path: clio-kit-mcp-servers/${{ matrix.mcp }}/htmlcov/ @@ -182,7 +152,6 @@ jobs: name: Security Audit - ${{ matrix.mcp }} runs-on: ubuntu-latest needs: discover-mcps - continue-on-error: true # Don't fail workflow on security vulnerabilities strategy: fail-fast: false matrix: @@ -192,37 +161,21 @@ jobs: - uses: actions/checkout@v4 with: submodules: 'recursive' - - - name: Install uv - uses: astral-sh/setup-uv@v3 + + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.12 - run: uv python install 3.12 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev pip-audit + mcp: ${{ matrix.mcp }} + dev-packages: pip-audit - name: Run security audit for ${{ matrix.mcp }} run: | cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv run pip-audit - else - echo "No pyproject.toml found for ${{ matrix.mcp }}, skipping security audit" - fi + uv run pip-audit - python-3-10: - name: Python 3.10 - ${{ matrix.mcp }} + validate-fastmcp: + name: Validate FastMCP - ${{ matrix.mcp }} runs-on: ubuntu-latest needs: discover-mcps - continue-on-error: true # Don't fail workflow on Python 3.10 test failures strategy: fail-fast: false matrix: @@ -232,37 +185,20 @@ jobs: - uses: actions/checkout@v4 with: submodules: 'recursive' - - - name: Install uv - uses: astral-sh/setup-uv@v3 + + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.10 - run: uv python install 3.10 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev pytest + mcp: ${{ matrix.mcp }} - - name: Run tests for ${{ matrix.mcp }} + - name: Validate FastMCP 3.0 compliance for ${{ matrix.mcp }} run: | cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -d tests ]; then - uv run pytest tests/ --tb=short -v - else - echo "No tests directory for ${{ matrix.mcp }}" - fi + uv run python ../../scripts/validate_fastmcp.py - python-3-11: - name: Python 3.11 - ${{ matrix.mcp }} + validate-server-json: + name: Validate server.json - ${{ matrix.mcp }} runs-on: ubuntu-latest needs: discover-mcps - continue-on-error: true # Don't fail workflow on Python 3.11 test failures strategy: fail-fast: false matrix: @@ -272,67 +208,40 @@ jobs: - uses: actions/checkout@v4 with: submodules: 'recursive' - - - name: Install uv - uses: astral-sh/setup-uv@v3 + + - uses: ./.github/actions/setup-mcp with: - version: "latest" - - - name: Set up Python 3.11 - run: uv python install 3.11 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev - fi - uv add --dev pytest + mcp: ${{ matrix.mcp }} - - name: Run tests for ${{ matrix.mcp }} + - name: Regenerate and diff server.json for ${{ matrix.mcp }} run: | cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -d tests ]; then - uv run pytest tests/ --tb=short -v - else - echo "No tests directory for ${{ matrix.mcp }}" + # Extract live metadata + LIVE=$(uv run python ../../scripts/extract_mcp_metadata.py) + + # Compare tool/resource/prompt counts from live metadata vs committed server.json + if [ ! -f server.json ]; then + echo "FAIL: server.json not found for ${{ matrix.mcp }}" + exit 1 fi - python-3-12: - name: Python 3.12 - ${{ matrix.mcp }} - runs-on: ubuntu-latest - needs: discover-mcps - strategy: - fail-fast: false - matrix: - mcp: ${{ fromJson(needs.discover-mcps.outputs.mcps) }} - max-parallel: 20 - steps: - - uses: actions/checkout@v4 - with: - submodules: 'recursive' - - - name: Install uv - uses: astral-sh/setup-uv@v3 - with: - version: "latest" - - - name: Set up Python 3.12 - run: uv python install 3.12 - - - name: Install dependencies for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -f pyproject.toml ]; then - uv sync --all-extras --dev + # Validate JSON is well-formed + python3 -c "import json, sys; json.load(open('server.json'))" || { + echo "FAIL: server.json is not valid JSON" + exit 1 + } + + # Verify tool names match between live metadata and server.json + LIVE_TOOLS=$(echo "$LIVE" | python3 -c "import json,sys; d=json.load(sys.stdin); print('\n'.join(sorted(t['name'] for t in d.get('tools',[]))))") + JSON_TOOLS=$(python3 -c "import json; d=json.load(open('server.json')); print('\n'.join(sorted(t['name'] for t in d.get('tools',[]))))") + + if [ "$LIVE_TOOLS" != "$JSON_TOOLS" ]; then + echo "FAIL: server.json tools out of sync with live metadata" + echo "--- Live tools ---" + echo "$LIVE_TOOLS" + echo "--- server.json tools ---" + echo "$JSON_TOOLS" + exit 1 fi - uv add --dev pytest - - name: Run tests for ${{ matrix.mcp }} - run: | - cd clio-kit-mcp-servers/${{ matrix.mcp }} - if [ -d tests ]; then - uv run pytest tests/ --tb=short -v - else - echo "No tests directory for ${{ matrix.mcp }}" - fi \ No newline at end of file + echo "PASS: server.json is in sync for ${{ matrix.mcp }}" diff --git a/.github/workflows/test-mcps.yml b/.github/workflows/test-mcps.yml deleted file mode 100644 index 99eb69d6..00000000 --- a/.github/workflows/test-mcps.yml +++ /dev/null @@ -1,66 +0,0 @@ -name: Run MCP tests - -on: - workflow_dispatch: # Manual trigger only - redundant with quality_control.yml - -jobs: - test-mcps: - runs-on: ubuntu-latest - strategy: - fail-fast: false - matrix: - mcp: - - name: "adios" - path: "clio-kit-mcp-servers/adios" - - name: "arxiv" - path: "clio-kit-mcp-servers/arxiv" - - name: "compression" - path: "clio-kit-mcp-servers/compression" - - name: "darshan" - path: "clio-kit-mcp-servers/darshan" - - name: "hdf5" - path: "clio-kit-mcp-servers/hdf5" - - name: "jarvis" - path: "clio-kit-mcp-servers/jarvis" - - name: "lmod" - path: "clio-kit-mcp-servers/lmod" - - name: "node-hardware" - path: "clio-kit-mcp-servers/node-hardware" - - name: "pandas" - path: "clio-kit-mcp-servers/pandas" - - name: "parallel-sort" - path: "clio-kit-mcp-servers/parallel-sort" - - name: "paraview" - path: "clio-kit-mcp-servers/paraview" - - name: "parquet" - path: "clio-kit-mcp-servers/parquet" - - name: "plot" - path: "clio-kit-mcp-servers/plot" - - name: "slurm" - path: "clio-kit-mcp-servers/slurm" - - name: Test ${{ matrix.mcp.name }} - - steps: - - name: Checkout code - uses: actions/checkout@v4 - - - name: Set up Python - uses: actions/setup-python@v5 - with: - python-version: '3.12' - - - name: Install uv - uses: astral-sh/setup-uv@v3 - - - name: Install Slurm dependencies - if: matrix.mcp.name == 'slurm' - run: | - sudo apt-get update - sudo apt-get install -y slurm-wlm - - - name: Run tests for ${{ matrix.mcp.name }} - working-directory: ${{ matrix.mcp.path }} - run: | - uv run pytest --tb=short -v - diff --git a/CLAUDE.md b/CLAUDE.md index e77e30e9..b1d93ab3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,15 +10,15 @@ The repository uses a **unified launcher with auto-discovery** pattern: each MCP **Platform Context**: CLIO Kit is the tooling layer of the IoWarp platform, providing comprehensive agent capabilities beyond just MCP servers. -**Key Technologies**: FastMCP, Python 3.10+, UV package manager, Pydantic, pytest, Ruff +**Key Technologies**: FastMCP 3.0, Python 3.10+, UV package manager, Pydantic, pytest, Ruff ## Project Structure ``` clio-kit/ # Monorepo root ├── src/clio_kit/ # Unified launcher CLI -├── clio-kit-mcp-servers/ # 15 independent MCP servers -│ ├── hdf5/ ⭐ # Flagship server (v2.0, 25+ tools) +├── clio-kit-mcp-servers/ # 16 independent MCP servers +│ ├── hdf5/ ⭐ # Flagship server (v2.0, 28 tools) │ ├── pandas/ # Data analysis operations │ ├── slurm/ # HPC job management │ ├── arxiv/ # Research paper fetching @@ -30,6 +30,7 @@ clio-kit/ # Monorepo root │ ├── ndp/ # Dataset discovery │ ├── node-hardware/ # System hardware info │ ├── parallel-sort/ # Large file sorting +│ ├── paraview/ # Scientific visualization │ ├── parquet/ # Parquet file handling │ ├── plot/ # Data visualization │ ├── adios/ # ADIOS2 data I/O @@ -79,6 +80,9 @@ uv run pytest -v --cov=src/ # pip-audit: Security vulnerabilities uv run pip-audit + +# FastMCP 3.0 validation (instructions, annotations, tags, resources, prompts) +uv run python ../../scripts/validate_fastmcp.py ``` #### Quick test runs: @@ -148,30 +152,73 @@ ServerName/ └── uv.lock # Dependency lock ``` -### FastMCP Decorators Pattern +### FastMCP 3.0 Server Pattern + +All servers use FastMCP 3.0 and must include: instructions, tool annotations, tool tags, at least 1 resource, and at least 1 prompt. ```python from fastmcp import FastMCP - -mcp = FastMCP("server-name") - -# Expose Python function as MCP tool -@mcp.tool(description="What this tool does") -def my_tool(param1: str, param2: int) -> str: - return result - -# Expose resources (URI scheme: scheme://path) -@mcp.resource(uri_template="scheme://{path}") -def get_resource(path: str) -> str: - return content - -# Multi-step workflows with prompts +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message + +mcp = FastMCP( + "server-name", + instructions="Brief description of what this server does and when to use each tool.", + list_page_size=10, # Required for servers with 10+ tools +) + +# Tools: always include annotations and tags +@mcp.tool( + description="1-2 sentence description of what this tool does.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"category", "subcategory"}, +) +async def my_tool(param1: str, param2: int) -> str: + try: + return do_work(param1, param2) + except Exception as e: + raise ToolError(f"Operation failed: {e}") from e + +# Resources: at least 1 per server +@mcp.resource("server-name://capabilities") +def capabilities() -> dict: + """What this server can do.""" + return {"features": [...]} + +# Resource templates (parameterized) +@mcp.resource("server-name://{file_path}/metadata") +def file_metadata(file_path: str) -> dict: + return get_metadata(file_path) + +# Prompts: at least 1 per server @mcp.prompt() -def workflow() -> list[Message]: - return [Message(...), Message(...)] +def guided_workflow(input_path: str) -> list[Message]: + """Guided workflow for common operations.""" + return [ + Message(f"Analyze the data at {input_path}. First summarize, then process."), + ] + +def main() -> None: + import os, argparse + parser = argparse.ArgumentParser() + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + mcp.run(transport=transport, host=args.host, port=args.port) +``` + +### Key FastMCP 3.0 Imports -async def main(): - await mcp.run() +```python +from fastmcp import FastMCP, Context +from fastmcp.exceptions import ToolError, ResourceError +from fastmcp.prompts import Message ``` ### Configuration with Pydantic @@ -224,30 +271,48 @@ The HDF5 server (v2.0) implements patterns useful for all MCPs: ## Adding a New MCP Server 1. Create directory: `clio-kit-mcp-servers/my-server/` (use kebab-case) -2. Create `pyproject.toml` with: +2. Create `pyproject.toml` with hatchling build backend: ```toml + [build-system] + requires = ["hatchling"] + build-backend = "hatchling.build" + [project] name = "my-server-mcp" version = "1.0.0" + dependencies = ["fastmcp>=3.0.0rc2"] [project.scripts] my-server-mcp = "my_server_mcp.server:main" ``` -3. Implement `src/my_server_mcp/server.py` using FastMCP decorators +3. Implement `src/my_server_mcp/server.py` following the FastMCP 3.0 pattern above. **Required**: + - `instructions=` on `FastMCP()` constructor + - `annotations=` and `tags=` on every `@mcp.tool()` + - `ToolError` for all error paths (not error dicts) + - At least 1 `@mcp.resource()` + - At least 1 `@mcp.prompt()` returning `list[Message]` + - `list_page_size=10` if server has 10+ tools 4. Add tests in `tests/` directory -5. Launcher auto-discovers it on next run +5. Validate: `uv run python ../../scripts/validate_fastmcp.py` +6. Launcher auto-discovers it on next run ## CI/CD Pipeline **Quality Control** (`.github/workflows/quality_control.yml`): - Auto-discovers all MCPs with `pyproject.toml` -- Runs 4 checks in parallel per MCP: +- Uses reusable composite action (`.github/actions/setup-mcp/action.yml`) for setup +- Runs 5 checks in parallel per MCP: - Ruff linting + formatting - - MyPy type checking - - pytest with coverage + - MyPy type checking (advisory, non-blocking) + - pytest with coverage (matrix: Python 3.10, 3.11, 3.12) - pip-audit security scan -- Tests Python 3.10, 3.11, 3.12 -- Coverage uploaded to Codecov + - FastMCP 3.0 validation (`scripts/validate_fastmcp.py`) +- Coverage uploaded to Codecov (Python 3.12 only) + +**Docs & Website** (`.github/workflows/docs-and-website.yml`): +- Generates Docusaurus docs via `scripts/generate_docs.py` +- Updates README files via `scripts/readme_filler.py` +- Both use `scripts/extract_mcp_metadata.py` (FastMCP async API, not AST parsing) **Key Note**: Chronolog MCP has dedicated workflow (requires system dependencies) @@ -256,15 +321,20 @@ The HDF5 server (v2.0) implements patterns useful for all MCPs: - **Minimum Python**: 3.10 (enforced in root `pyproject.toml`) - **Package Manager**: UV (not pip/conda) - **Build System**: Hatchling -- **Key Frameworks**: FastMCP 0.2.0+, Pydantic 2.4.2+ +- **Key Frameworks**: FastMCP 3.0.0rc2+, Pydantic 2.4.2+ ## Important Files Reference | Purpose | Path | |---------|------| | Main Launcher | `src/clio_kit/__init__.py` | -| HDF5 Server Example | `clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py` | +| HDF5 Server (reference) | `clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py` | | Quality Control CI | `.github/workflows/quality_control.yml` | +| Composite Action | `.github/actions/setup-mcp/action.yml` | +| FastMCP Validator | `scripts/validate_fastmcp.py` | +| Metadata Extractor | `scripts/extract_mcp_metadata.py` | +| Doc Generator | `scripts/generate_docs.py` | +| README Updater | `scripts/readme_filler.py` | | Main Configuration | `pyproject.toml` | | Main Docs Site | `clio-kit-website/` | @@ -273,7 +343,7 @@ The HDF5 server (v2.0) implements patterns useful for all MCPs: ### Server Won't Start 1. Check if `pyproject.toml` has correct entry point: `name-mcp = "module:server:main"` -2. Verify server file has `async def main()` and proper MCP initialization +2. Verify server file has `def main()` with argparse and `mcp.run()` call 3. Test directly: `cd clio-kit-mcp-servers/hdf5 && uv run hdf5-mcp` ### Tests Failing diff --git a/claude_desktop_config.json b/claude_desktop_config.json new file mode 100644 index 00000000..18b3ce27 --- /dev/null +++ b/claude_desktop_config.json @@ -0,0 +1,116 @@ +{ + "mcpServers": { + "clio-adios": { + "command": "uvx", + "args": [ + "clio-kit", + "adios" + ] + }, + "clio-arxiv": { + "command": "uvx", + "args": [ + "clio-kit", + "arxiv" + ] + }, + "clio-chronolog": { + "command": "uvx", + "args": [ + "clio-kit", + "chronolog" + ] + }, + "clio-compression": { + "command": "uvx", + "args": [ + "clio-kit", + "compression" + ] + }, + "clio-darshan": { + "command": "uvx", + "args": [ + "clio-kit", + "darshan" + ] + }, + "clio-hdf5": { + "command": "uvx", + "args": [ + "clio-kit", + "hdf5" + ] + }, + "clio-jarvis": { + "command": "uvx", + "args": [ + "clio-kit", + "jarvis" + ] + }, + "clio-lmod": { + "command": "uvx", + "args": [ + "clio-kit", + "lmod" + ] + }, + "clio-ndp": { + "command": "uvx", + "args": [ + "clio-kit", + "ndp" + ] + }, + "clio-node-hardware": { + "command": "uvx", + "args": [ + "clio-kit", + "node-hardware" + ] + }, + "clio-pandas": { + "command": "uvx", + "args": [ + "clio-kit", + "pandas" + ] + }, + "clio-parallel-sort": { + "command": "uvx", + "args": [ + "clio-kit", + "parallel-sort" + ] + }, + "clio-paraview": { + "command": "uvx", + "args": [ + "clio-kit", + "paraview" + ] + }, + "clio-parquet": { + "command": "uvx", + "args": [ + "clio-kit", + "parquet" + ] + }, + "clio-plot": { + "command": "uvx", + "args": [ + "clio-kit", + "plot" + ] + }, + "clio-slurm": { + "command": "uvx", + "args": [ + "clio-kit", + "slurm" + ] + } + } +} diff --git a/clio-kit-mcp-servers/adios/.claude-plugin/plugin.json b/clio-kit-mcp-servers/adios/.claude-plugin/plugin.json new file mode 100644 index 00000000..f2ca24b5 --- /dev/null +++ b/clio-kit-mcp-servers/adios/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-adios", + "description": "Fetch and analyze BP5 data files using ADIOS2. Access scientific data, metadata, and attributes for research and analysis purposes.", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/adios/.mcp.json b/clio-kit-mcp-servers/adios/.mcp.json new file mode 100644 index 00000000..6f89157b --- /dev/null +++ b/clio-kit-mcp-servers/adios/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-adios": { + "command": "uvx", + "args": [ + "clio-kit", + "adios" + ] + } +} diff --git a/clio-kit-mcp-servers/adios/README.md b/clio-kit-mcp-servers/adios/README.md index a20c31a0..cfe77239 100644 --- a/clio-kit-mcp-servers/adios/README.md +++ b/clio-kit-mcp-servers/adios/README.md @@ -143,50 +143,89 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\adios run adios-mcp ## Capabilities ### `list_bp5` -**Description**: List all BP5 files in a specified directory with comprehensive file information including metadata and structure details. +**Description**: Lists all BP5 files in a given directory. The 'directory' parameter must be an absolute path. +**Hints**: read-only, idempotent +**Tags**: adios, scientific-io -**Parameters**: -- `directory` (str): Absolute path to directory containing BP5 files +### `inspect_variables` +**Description**: Inspects variables in a BP5 file, returning type, shape, and steps. Optionally filters by variable name. +**Hints**: read-only, idempotent +**Tags**: adios, variables -**Returns**: List of BP5 files with metadata, size information, and basic structure details. +### `inspect_variables_at_step` +**Description**: Inspects a specific variable at a given step in a BP5 file. All parameters are required. +**Hints**: read-only, idempotent +**Tags**: adios, variables -### `inspect_variables` -**Description**: Inspect all variables in a BP5 file including type information, shape dimensions, and available time steps for comprehensive data structure analysis. If variable_name is provided, returns data for that specific variable. +### `inspect_attributes` +**Description**: Reads global or variable-specific attributes from a BP5 file. The 'variable_name' is optional. +**Hints**: read-only, idempotent +**Tags**: adios, attributes -**Parameters**: -- `filename` (str): Absolute path to BP5 file -- `variable_name` (str, optional): Specific variable name for targeted inspection +### `read_variable_at_step` +**Description**: Reads a named variable at a specific step from a BP5 file. All parameters are required. +**Hints**: read-only, idempotent +**Tags**: adios, variables -**Returns**: Complete variable inventory with types, shapes, step counts, and data structure information for all variables or specific variable. +### Resources -### `inspect_variables_at_step` -**Description**: Inspect a specific variable at a given step in a BP5 file. Shows variable type, shape, and metadata at the specified time step. +- `adios://capabilities` - ADIOS2 file format capabilities and supported engines. -**Parameters**: -- `filename` (str): Absolute path to BP5 file -- `variable_name` (str): Name of the variable to inspect -- `step` (int): Step number to inspect +### Prompts -**Returns**: Variable information at the specified step including type, shape, and available metadata. +- **explore_bp_file**: Guided workflow for exploring an ADIOS2 BP file. +## Claude Code -### `inspect_attributes` -**Description**: Read global or variable-specific attributes from a BP5 file with detailed metadata extraction and attribute value analysis. +```bash +claude mcp add clio-adios -- uvx clio-kit adios +``` -**Parameters**: -- `filename` (str): Absolute path to BP5 file -- `variable_name` (str, optional): Specific variable name for targeted attribute inspection +Or install via the CLIO Kit plugin marketplace: -**Returns**: Comprehensive attribute dictionary with metadata, variable-specific attributes, and global file attributes. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-adios@iowarp-clio-kit +``` +## Claude Desktop -### `read_variable_at_step` -**Description**: Read a named variable at a specific time step from a BP5 file with full data extraction and conversion to Python native types. +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Parameters**: -- `filename` (str): Absolute path to BP5 file -- `variable_name` (str): Name of variable to read -- `target_step` (int): Time step number to read from +```json +{ + "mcpServers": { + "clio-adios": { + "command": "uvx", + "args": [ + "clio-kit", + "adios" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-adios": { + "command": "uvx", + "args": [ + "clio-kit", + "adios" + ] + } + } +} +``` + +Or install the CLIO Kit extension: -**Returns**: Variable data as Python scalar or list (flattened array) at the specified step. +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Scientific Data Structure Analysis diff --git a/clio-kit-mcp-servers/adios/pyproject.toml b/clio-kit-mcp-servers/adios/pyproject.toml index b0b0a85c..703b2eb2 100644 --- a/clio-kit-mcp-servers/adios/pyproject.toml +++ b/clio-kit-mcp-servers/adios/pyproject.toml @@ -22,7 +22,7 @@ keywords = [ ] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "numpy", "adios2", "h11>=0.16.0" @@ -33,7 +33,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -adios-mcp = "server:main" +adios-mcp = "adios_mcp.server:main" [dependency-groups] dev = [ @@ -45,5 +45,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/adios_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/adios/server.json b/clio-kit-mcp-servers/adios/server.json new file mode 100644 index 00000000..8982abe4 --- /dev/null +++ b/clio-kit-mcp-servers/adios/server.json @@ -0,0 +1,56 @@ +{ + "name": "io.github.iowarp/adios-mcp", + "description": "Fetch and analyze BP5 data files using ADIOS2. Access scientific data, metadata, and attributes for research and analysis purposes.", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "adios" + ] + }, + "tools": [ + { + "name": "list_bp5", + "description": "Lists all BP5 files in a given directory. The 'directory' parameter must be an absolute path." + }, + { + "name": "inspect_variables", + "description": "Inspects variables in a BP5 file, returning type, shape, and steps. Optionally filters by variable name." + }, + { + "name": "inspect_variables_at_step", + "description": "Inspects a specific variable at a given step in a BP5 file. All parameters are required." + }, + { + "name": "inspect_attributes", + "description": "Reads global or variable-specific attributes from a BP5 file. The 'variable_name' is optional." + }, + { + "name": "read_variable_at_step", + "description": "Reads a named variable at a specific step from a BP5 file. All parameters are required." + } + ], + "resources": [ + { + "uri": "adios://capabilities", + "name": "adios_capabilities", + "description": "ADIOS2 file format capabilities and supported engines." + } + ], + "prompts": [ + { + "name": "explore_bp_file", + "description": "Guided workflow for exploring an ADIOS2 BP file." + } + ], + "tags": [ + "scientific-computing", + "adios2", + "bp5", + "data-io", + "hpc" + ] +} diff --git a/clio-kit-mcp-servers/jarvis/src/__init__.py b/clio-kit-mcp-servers/adios/src/adios_mcp/__init__.py similarity index 100% rename from clio-kit-mcp-servers/jarvis/src/__init__.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/__init__.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/__init__.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/__init__.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/__init__.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/__init__.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/bp5_attributes.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_attributes.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/bp5_attributes.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_attributes.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/bp5_inspect_variables.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_inspect_variables.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/bp5_inspect_variables.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_inspect_variables.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/bp5_inspect_variables_at_step.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_inspect_variables_at_step.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/bp5_inspect_variables_at_step.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_inspect_variables_at_step.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/bp5_list.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_list.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/bp5_list.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_list.py diff --git a/clio-kit-mcp-servers/adios/src/implementation/bp5_read_variable_at_step.py b/clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_read_variable_at_step.py similarity index 100% rename from clio-kit-mcp-servers/adios/src/implementation/bp5_read_variable_at_step.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/implementation/bp5_read_variable_at_step.py diff --git a/clio-kit-mcp-servers/adios/src/mcp_handlers.py b/clio-kit-mcp-servers/adios/src/adios_mcp/mcp_handlers.py similarity index 58% rename from clio-kit-mcp-servers/adios/src/mcp_handlers.py rename to clio-kit-mcp-servers/adios/src/adios_mcp/mcp_handlers.py index 61b9412c..2f354259 100644 --- a/clio-kit-mcp-servers/adios/src/mcp_handlers.py +++ b/clio-kit-mcp-servers/adios/src/adios_mcp/mcp_handlers.py @@ -1,7 +1,9 @@ # mcp_handlers.py -import json from typing import Any, Dict, Optional -from implementation import ( + +from fastmcp.exceptions import ToolError + +from .implementation import ( bp5_list, bp5_inspect_variables, bp5_attributes, @@ -17,8 +19,7 @@ class UnknownToolError(Exception): async def list_bp5_files(directory: str = "data") -> Dict[str, Any]: - """ - List all BP5 files in a specified directory with comprehensive file information including metadata and structure details. + """List all BP5 files in a specified directory. Args: directory: Path to the directory containing BP5 files @@ -30,18 +31,13 @@ async def list_bp5_files(directory: str = "data") -> Dict[str, Any]: files = bp5_list.list_bp5(directory) return {"files": files} except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "list_bp5", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e async def inspect_variables_handler( filename: str, variable_name: Optional[str] = None ) -> Dict[str, Any]: - """ - Async handler for 'inspect_variables' tool. + """Async handler for 'inspect_variables' tool. Args: filename: Path to the BP5 file @@ -52,25 +48,17 @@ async def inspect_variables_handler( """ try: if variable_name: - # If variable name is provided, use read_variable_at_step to get its data - # We'll get data from step 0 as a default return bp5_inspect_variables.inspect_variables(filename, variable_name) else: - # If no variable name, return metadata for all variables return bp5_inspect_variables.inspect_variables(filename) except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_variables", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e async def inspect_variables_at_step_handler( filename: str, variable_name: str, step: int ) -> Dict[str, Any]: - """ - Async handler for 'inspect_variables_at_step' tool. + """Async handler for 'inspect_variables_at_step' tool. Args: filename: Path to the BP5 file @@ -86,40 +74,27 @@ async def inspect_variables_at_step_handler( ) return result except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_variables_at_step", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e async def inspect_attributes_handler( filename: str, variable_name: Optional[str] = None ) -> Dict[str, Any]: - """ - Async handler for 'inspect_attributes' tool. - """ + """Async handler for 'inspect_attributes' tool.""" try: return bp5_attributes.inspect_attributes(filename, variable_name) except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_attributes", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e async def read_variable_at_step_handler( filename: str, variable_name: str, target_step: int ) -> Dict[str, Any]: + """Async handler for 'read_variable_at_step' tool.""" try: value = bp5_read_variable_at_step.read_variable_at_step( filename, variable_name, target_step ) return {"value": value} except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "read_variable_at_step", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e diff --git a/clio-kit-mcp-servers/adios/src/adios_mcp/server.py b/clio-kit-mcp-servers/adios/src/adios_mcp/server.py new file mode 100644 index 00000000..9b593334 --- /dev/null +++ b/clio-kit-mcp-servers/adios/src/adios_mcp/server.py @@ -0,0 +1,164 @@ +# server.py + +# Created on: 2nd June, 2025 +# Author: Soham Sonar ssonar2@hawk.illinoistech.edu + + +import os +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError # noqa: F401 (re-exported for consumers) +from fastmcp.prompts import Message +from typing import Optional +from . import mcp_handlers + +# Initialize FastMCP server +mcp: FastMCP = FastMCP( + "adios", + instructions=( + "Reads and inspects ADIOS2 BP files for scientific I/O. " + "Use list_variables to see available data, read_variable to extract values, " + "and get_file_info for metadata overview." + ), +) + +# ─── ADIOS BP5 TOOLS ───────────────────────────────────────────────────────── + + +# List BP5 Files Tool +@mcp.tool( + name="list_bp5", + description="Lists all BP5 files in a given directory. The 'directory' parameter must be an absolute path.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"adios", "scientific-io"}, +) +async def list_bp5_tool(directory: str = "data/") -> dict: + """List all BP5 files in a specified directory with file metadata.""" + return await mcp_handlers.list_bp5_files(directory) + + +# ─── INSPECT VARIABLES ─────────────────────────────────────────────────────── +@mcp.tool( + name="inspect_variables", + description="Inspects variables in a BP5 file, returning type, shape, and steps. Optionally filters by variable name.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"adios", "variables"}, +) +async def inspect_variables_tool( + filename: str, variable_name: Optional[str] = None +) -> dict: + """Inspect all variables in a BP5 file or a specific variable by name.""" + return await mcp_handlers.inspect_variables_handler(filename, variable_name) + + +# ─── INSPECT VARIABLES AT STEP ───────────────────────────────────────────────── +@mcp.tool( + name="inspect_variables_at_step", + description="Inspects a specific variable at a given step in a BP5 file. All parameters are required.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"adios", "variables"}, +) +async def inspect_variables_at_step_tool( + filename: str, variable_name: str, step: int +) -> dict: + """Inspect a specific variable at a given step in a BP5 file.""" + return await mcp_handlers.inspect_variables_at_step_handler( + filename, variable_name, step + ) + + +# ─── INSPECT ATTRIBUTES ────────────────────────────────────────────────────── +@mcp.tool( + name="inspect_attributes", + description="Reads global or variable-specific attributes from a BP5 file. The 'variable_name' is optional.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"adios", "attributes"}, +) +async def inspect_attributes_tool( + filename: str, variable_name: Optional[str] = None +) -> dict: + """Read global or variable-specific attributes from a BP5 file.""" + return await mcp_handlers.inspect_attributes_handler(filename, variable_name) + + +# ─── READ VARIABLE AT STEP ──────────────────────────────────────────────────── +@mcp.tool( + name="read_variable_at_step", + description="Reads a named variable at a specific step from a BP5 file. All parameters are required.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"adios", "variables"}, +) +async def read_variable_at_step_tool( + filename: str, variable_name: str, target_step: int +) -> dict: + """Read a named variable at a specific time step from a BP5 file.""" + return await mcp_handlers.read_variable_at_step_handler( + filename, variable_name, target_step + ) + + +# ─── RESOURCES ──────────────────────────────────────────────────────────────── + + +@mcp.resource("adios://capabilities") +def adios_capabilities() -> dict: + """ADIOS2 file format capabilities and supported engines.""" + return { + "supported_formats": ["BP4", "BP5"], + "operations": ["read", "inspect", "list variables", "read attributes"], + } + + +# ─── PROMPTS ────────────────────────────────────────────────────────────────── + + +@mcp.prompt() +def explore_bp_file(file_path: str) -> list[Message]: + """Guided workflow for exploring an ADIOS2 BP file.""" + return [ + Message( + f"I need to explore the ADIOS2 BP file at {file_path}. " + "First get the file info, then list all variables, " + "and read the first few values of the most important variables." + ), + ] + + +def main() -> None: + """Main entry point for the ADIOS MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="ADIOS MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/adios/src/server.py b/clio-kit-mcp-servers/adios/src/server.py deleted file mode 100644 index 2ba6897b..00000000 --- a/clio-kit-mcp-servers/adios/src/server.py +++ /dev/null @@ -1,187 +0,0 @@ -# server.py - -# Created on: 2nd June, 2025 -# Author: Soham Sonar ssonar2@hawk.illinoistech.edu - - -import os -import sys -import json -from fastmcp import FastMCP -from dotenv import load_dotenv -from typing import Optional -import mcp_handlers - -# Ensure parent directory is on PYTHONPATH so "capabilities" can be found -sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) - -# Load .env variables, if any -load_dotenv() - -# Initialize FastMCP server -mcp: FastMCP = FastMCP("ADIOSMCP") - -# ─── ADIOS BP5 TOOLS ───────────────────────────────────────────────────────── - - -# List BP5 Files Tool -@mcp.tool( - name="list_bp5", - description="Lists all BP5 files in a given directory, the bp5 files are actually directories so both file and directory words are correct. The 'directory' parameter must be an absolute path.", -) -async def list_bp5_tool(directory: str = "data/") -> dict: - """ - List all BP5 files in a specified directory with comprehensive file information including metadata and structure details. - - Args: - directory (str): Absolute path to directory containing BP5 files - - Returns: - List of BP5 files with metadata, size information, and basic structure details. - """ - try: - return await mcp_handlers.list_bp5_files(directory) - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "list_bp5", "error": type(e).__name__}, - "isError": True, - } - - -# ─── INSPECT VARIABLES ─────────────────────────────────────────────────────── -@mcp.tool( - name="inspect_variables", - description="Inspects variables in a BP5 file. If variable_name is provided, returns data for that specific variable. Otherwise, shows type, shape, and steps for all variables. The 'filename' parameter must be an absolute path to the BP5 file.", -) -async def inspect_variables_tool( - filename: str, variable_name: Optional[str] = None -) -> dict: - """ - Inspect all variables in a BP5 file including type information, shape dimensions, and available time steps for comprehensive data structure analysis. If variable_name is provided, returns data for that specific variable. - - Args: - filename (str): Absolute path to BP5 file - variable_name (str, optional): Specific variable name for targeted inspection - - Returns: - Complete variable inventory with types, shapes, step counts, and data structure information for all variables or specific variable. - """ - try: - return await mcp_handlers.inspect_variables_handler(filename, variable_name) - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_variables", "error": type(e).__name__}, - "isError": True, - } - - -# ─── INSPECT VARIABLES AT STEP ───────────────────────────────────────────────── -@mcp.tool( - name="inspect_variables_at_step", - description="Inspects a specific variable at a given step in a BP5 file. Shows variable type, shape, min, max. All parameters are required. The 'filename' must be an absolute path.", -) -async def inspect_variables_at_step_tool( - filename: str, variable_name: str, step: int -) -> dict: - """ - Inspect a specific variable at a given step in a BP5 file. Shows variable type, shape, and metadata at the specified time step. - - Args: - filename (str): Absolute path to BP5 file - variable_name (str): Name of the variable to inspect - step (int): Step number to inspect - - Returns: - Variable information at the specified step including type, shape, and available metadata. - """ - try: - return await mcp_handlers.inspect_variables_at_step_handler( - filename, variable_name, step - ) - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_variables_at_step", "error": type(e).__name__}, - "isError": True, - } - - -# ─── INSPECT ATTRIBUTES ────────────────────────────────────────────────────── -@mcp.tool( - name="inspect_attributes", - description="Reads global or variable-specific attributes from a BP5 file. The 'filename' parameter must be an absolute path. The 'variable_name' is optional.", -) -async def inspect_attributes_tool( - filename: str, variable_name: Optional[str] = None -) -> dict: - """ - Read global or variable-specific attributes from a BP5 file with detailed metadata extraction and attribute value analysis. - - Args: - filename (str): Absolute path to BP5 file - variable_name (str, optional): Specific variable name for targeted attribute inspection - - Returns: - Comprehensive attribute dictionary with metadata, variable-specific attributes, and global file attributes. - """ - try: - return await mcp_handlers.inspect_attributes_handler(filename, variable_name) - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "inspect_attributes", "error": type(e).__name__}, - "isError": True, - } - - -# ─── READ VARIABLE AT STEP ──────────────────────────────────────────────────── -@mcp.tool( - name="read_variable_at_step", - description="Reads a named variable at a specific step from a BP5 file. All parameters are required. The 'filename' must be an absolute path.", -) -async def read_variable_at_step_tool( - filename: str, variable_name: str, target_step: int -) -> dict: - """ - Read a named variable at a specific time step from a BP5 file with full data extraction and conversion to Python native types. - - Args: - filename (str): Absolute path to BP5 file - variable_name (str): Name of variable to read - target_step (int): Time step number to read from - - Returns: - Variable data as Python scalar or list (flattened array) at the specified step. - """ - return await mcp_handlers.read_variable_at_step_handler( - filename, variable_name, target_step - ) - - -def main(): - """ - Main entry point to run the ADIOS MCP server. - Chooses between stdio or SSE transport based on MCP_TRANSPORT. - """ - try: - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - if transport == "sse": - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") - except Exception as e: - print(json.dumps({"error": str(e)}), file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/adios/tests/test_bp5_attributes.py b/clio-kit-mcp-servers/adios/tests/test_bp5_attributes.py index 5e8ee766..ee2f6c2a 100644 --- a/clio-kit-mcp-servers/adios/tests/test_bp5_attributes.py +++ b/clio-kit-mcp-servers/adios/tests/test_bp5_attributes.py @@ -1,11 +1,11 @@ import pytest import numpy as np from unittest.mock import Mock, patch -from src.implementation.bp5_attributes import inspect_attributes +from adios_mcp.implementation.bp5_attributes import inspect_attributes class TestInspectAttributes: - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_global_attributes_success(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -29,7 +29,7 @@ def test_inspect_global_attributes_success(self, mock_file_reader): assert result["global_attr2"]["value"] == ["test_string"] assert result["global_attr2"]["Type"] == "string" - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_variable_attributes_success(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -53,7 +53,7 @@ def test_inspect_variable_attributes_success(self, mock_file_reader): assert result["var_attr2"]["value"] == [1, 2, 3] assert result["var_attr2"]["Type"] == "int64" - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_no_attributes(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -63,7 +63,7 @@ def test_inspect_attributes_no_attributes(self, mock_file_reader): assert result == {"error": "Invalid Variable name or no attributes found"} - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_empty_dict(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -73,7 +73,7 @@ def test_inspect_attributes_empty_dict(self, mock_file_reader): assert result == {"error": "Invalid Variable name or no attributes found"} - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_scalar_conversion(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -89,7 +89,7 @@ def test_inspect_attributes_scalar_conversion(self, mock_file_reader): assert result["scalar_attr"]["value"] == 5.5 assert isinstance(result["scalar_attr"]["value"], float) - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_array_conversion(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -105,7 +105,7 @@ def test_inspect_attributes_array_conversion(self, mock_file_reader): assert result["array_attr"]["value"] == [1, 2, 3, 4] assert isinstance(result["array_attr"]["value"], list) - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_with_elements_metadata(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -119,7 +119,7 @@ def test_inspect_attributes_with_elements_metadata(self, mock_file_reader): assert "Elements" in result["test_attr"] assert result["test_attr"]["Elements"] == "2" - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_variable_path_construction(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -132,7 +132,7 @@ def test_inspect_attributes_variable_path_construction(self, mock_file_reader): mock_stream.read_attribute.assert_called_with("my_var/var_attr") - @patch("src.implementation.bp5_attributes.FileReader") + @patch("adios_mcp.implementation.bp5_attributes.FileReader") def test_inspect_attributes_file_error(self, mock_file_reader): mock_file_reader.side_effect = FileNotFoundError("File not found") diff --git a/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables.py b/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables.py index 5e7b3108..54cf94c6 100644 --- a/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables.py +++ b/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables.py @@ -1,10 +1,10 @@ import pytest from unittest.mock import Mock, patch -from src.implementation.bp5_inspect_variables import inspect_variables +from adios_mcp.implementation.bp5_inspect_variables import inspect_variables class TestInspectVariables: - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_all_variables_success(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -33,7 +33,7 @@ def test_inspect_all_variables_success(self, mock_file_reader): assert result["temperature"]["Type"] == "double" assert result["pressure"]["Type"] == "float" - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_specific_variable_success(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -60,7 +60,7 @@ def test_inspect_specific_variable_success(self, mock_file_reader): assert result["temperature"]["Shape"] == "100,50,25" assert result["temperature"]["Type"] == "double" - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variable_not_found(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -78,7 +78,7 @@ def test_inspect_variable_not_found(self, mock_file_reader): assert result["error"] == "Variable 'nonexistent_var' not found in file." - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_empty_file(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -89,7 +89,7 @@ def test_inspect_variables_empty_file(self, mock_file_reader): assert result == {} - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_with_additional_params(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -112,7 +112,7 @@ def test_inspect_variables_with_additional_params(self, mock_file_reader): assert result["velocity"]["Max"] == "100.0" assert result["velocity"]["CustomParam"] == "CustomValue" - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_metadata_conversion(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -132,14 +132,14 @@ def test_inspect_variables_metadata_conversion(self, mock_file_reader): assert result["data"]["Shape"] == "10,20" assert result["data"]["Type"] == "int32" - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_file_error(self, mock_file_reader): mock_file_reader.side_effect = FileNotFoundError("File not found") with pytest.raises(FileNotFoundError): inspect_variables("nonexistent.bp") - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_default_parameter(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream @@ -152,7 +152,7 @@ def test_inspect_variables_default_parameter(self, mock_file_reader): assert len(result) == 1 assert "test_var" in result - @patch("src.implementation.bp5_inspect_variables.FileReader") + @patch("adios_mcp.implementation.bp5_inspect_variables.FileReader") def test_inspect_variables_case_sensitive(self, mock_file_reader): mock_stream = Mock() mock_file_reader.return_value.__enter__.return_value = mock_stream diff --git a/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables_at_step.py b/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables_at_step.py index 12bda930..46c74ec6 100644 --- a/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables_at_step.py +++ b/clio-kit-mcp-servers/adios/tests/test_bp5_inspect_variables_at_step.py @@ -1,10 +1,12 @@ import pytest from unittest.mock import Mock, patch -from src.implementation.bp5_inspect_variables_at_step import inspect_variables_at_step +from adios_mcp.implementation.bp5_inspect_variables_at_step import ( + inspect_variables_at_step, +) class TestInspectVariablesAtStep: - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_at_step_success(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -31,7 +33,7 @@ def test_inspect_variable_at_step_success(self, mock_stream_class): assert result["Min"] == "0.0" assert result["Max"] == "100.0" - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_at_step_zero(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -49,7 +51,7 @@ def test_inspect_variable_at_step_zero(self, mock_stream_class): assert result["Shape"] == "200,100" assert result["Type"] == "float" - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_not_found_at_step(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -66,7 +68,7 @@ def test_inspect_variable_not_found_at_step(self, mock_stream_class): ): inspect_variables_at_step("test.bp", "pressure", 0) - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_step_exceeds_available(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -79,7 +81,7 @@ def test_inspect_variable_step_exceeds_available(self, mock_stream_class): assert "error" in result assert "Step 5 exceeds available steps" in result["error"] - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_with_timeout(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -95,7 +97,7 @@ def test_inspect_variable_with_timeout(self, mock_stream_class): mock_stream.steps.assert_called_once_with(timeout=3) - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_runtime_error(self, mock_stream_class): mock_stream_class.side_effect = Exception("File access error") @@ -104,7 +106,7 @@ def test_inspect_variable_runtime_error(self, mock_stream_class): ): inspect_variables_at_step("test.bp", "temperature", 0) - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_multiple_steps_iteration(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -123,7 +125,7 @@ def test_inspect_variable_multiple_steps_iteration(self, mock_stream_class): assert result["Type"] == "int32" @patch("builtins.print") - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_prints_current_step(self, mock_stream_class, mock_print): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -139,7 +141,7 @@ def test_inspect_variable_prints_current_step(self, mock_stream_class, mock_prin mock_print.assert_called_once_with("Current step is 0") - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_file_not_found(self, mock_stream_class): mock_stream_class.side_effect = FileNotFoundError("File not found") @@ -148,7 +150,7 @@ def test_inspect_variable_file_not_found(self, mock_stream_class): ): inspect_variables_at_step("nonexistent.bp", "test_var", 0) - @patch("src.implementation.bp5_inspect_variables_at_step.Stream") + @patch("adios_mcp.implementation.bp5_inspect_variables_at_step.Stream") def test_inspect_variable_empty_variables_dict(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream diff --git a/clio-kit-mcp-servers/adios/tests/test_bp5_list.py b/clio-kit-mcp-servers/adios/tests/test_bp5_list.py index 6d44ab44..0cf285a0 100644 --- a/clio-kit-mcp-servers/adios/tests/test_bp5_list.py +++ b/clio-kit-mcp-servers/adios/tests/test_bp5_list.py @@ -2,7 +2,7 @@ import tempfile from pathlib import Path from unittest.mock import Mock, patch -from src.implementation.bp5_list import list_bp5 +from adios_mcp.implementation.bp5_list import list_bp5 class TestListBp5: @@ -15,7 +15,7 @@ def test_list_bp5_default_directory(self): (data_dir / "file2.bp5").touch() (data_dir / "file3.txt").touch() - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -28,7 +28,7 @@ def test_list_bp5_default_directory(self): assert Path("file2.bp5") in result def test_list_bp5_custom_directory(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -43,7 +43,7 @@ def test_list_bp5_custom_directory(self): assert len(result) == 2 def test_list_bp5_directory_not_found(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = False @@ -54,7 +54,7 @@ def test_list_bp5_directory_not_found(self): list_bp5("nonexistent") def test_list_bp5_only_bp_files(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -66,7 +66,7 @@ def test_list_bp5_only_bp_files(self): assert all(str(f).endswith(".bp") for f in result) def test_list_bp5_only_bp5_files(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -78,7 +78,7 @@ def test_list_bp5_only_bp5_files(self): assert all(str(f).endswith(".bp5") for f in result) def test_list_bp5_mixed_files(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -96,7 +96,7 @@ def test_list_bp5_mixed_files(self): assert len(bp5_files) == 2 def test_list_bp5_no_files_found(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -126,7 +126,7 @@ def test_list_bp5_with_real_temp_directory(self): assert bp5_files[0].name == "file2.bp5" def test_list_bp5_glob_patterns(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True @@ -140,7 +140,7 @@ def test_list_bp5_glob_patterns(self): assert calls[1][0][0] == "*.bp5" def test_list_bp5_return_type(self): - with patch("src.implementation.bp5_list.Path") as mock_path: + with patch("adios_mcp.implementation.bp5_list.Path") as mock_path: mock_base = Mock() mock_path.return_value = mock_base mock_base.exists.return_value = True diff --git a/clio-kit-mcp-servers/adios/tests/test_bp5_read_variable_at_step.py b/clio-kit-mcp-servers/adios/tests/test_bp5_read_variable_at_step.py index a825333d..6b9e9d0d 100644 --- a/clio-kit-mcp-servers/adios/tests/test_bp5_read_variable_at_step.py +++ b/clio-kit-mcp-servers/adios/tests/test_bp5_read_variable_at_step.py @@ -1,11 +1,11 @@ import pytest import numpy as np from unittest.mock import Mock, patch -from src.implementation.bp5_read_variable_at_step import read_variable_at_step +from adios_mcp.implementation.bp5_read_variable_at_step import read_variable_at_step class TestReadVariableAtStep: - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_scalar_success(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -26,7 +26,7 @@ def test_read_variable_scalar_success(self, mock_stream_class): assert isinstance(result, float) mock_stream.read.assert_called_once_with("temperature") - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_array_success(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -47,7 +47,7 @@ def test_read_variable_array_success(self, mock_stream_class): assert result == pytest.approx([1.1, 2.2, 3.3, 4.4], rel=1e-6) assert isinstance(result, list) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_not_found(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -62,7 +62,7 @@ def test_read_variable_not_found(self, mock_stream_class): with pytest.raises(ValueError, match="Variable 'pressure' not in step 0"): read_variable_at_step("test.bp", "pressure", 0) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_step_not_found(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -74,7 +74,7 @@ def test_read_variable_step_not_found(self, mock_stream_class): with pytest.raises(ValueError, match="Step 5 not found in file 'test.bp'"): read_variable_at_step("test.bp", "temperature", 5) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_zero_dimensional_array(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -94,7 +94,7 @@ def test_read_variable_zero_dimensional_array(self, mock_stream_class): assert result == 42 assert isinstance(result, int) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_multiple_steps(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -113,7 +113,7 @@ def test_read_variable_multiple_steps(self, mock_stream_class): assert result == [10.0, 20.0, 30.0] - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_numpy_generic_type(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -133,7 +133,7 @@ def test_read_variable_numpy_generic_type(self, mock_stream_class): assert result == 123456789 assert isinstance(result, int) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_1d_array(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -153,7 +153,7 @@ def test_read_variable_1d_array(self, mock_stream_class): assert result == [1, 2, 3, 4, 5] assert isinstance(result, list) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_3d_array_flattened(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream @@ -175,14 +175,14 @@ def test_read_variable_3d_array_flattened(self, mock_stream_class): assert result == [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0] assert isinstance(result, list) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_file_error(self, mock_stream_class): mock_stream_class.side_effect = FileNotFoundError("File not found") with pytest.raises(FileNotFoundError): read_variable_at_step("nonexistent.bp", "temperature", 0) - @patch("src.implementation.bp5_read_variable_at_step.adios2.Stream") + @patch("adios_mcp.implementation.bp5_read_variable_at_step.adios2.Stream") def test_read_variable_empty_variables_dict(self, mock_stream_class): mock_stream = Mock() mock_stream_class.return_value.__enter__.return_value = mock_stream diff --git a/clio-kit-mcp-servers/adios/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/adios/tests/test_mcp_handlers.py index b2d2bc64..87aa91ce 100644 --- a/clio-kit-mcp-servers/adios/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/adios/tests/test_mcp_handlers.py @@ -1,7 +1,7 @@ import pytest -import json from unittest.mock import patch -from src.mcp_handlers import ( +from fastmcp.exceptions import ToolError +from adios_mcp.mcp_handlers import ( UnknownToolError, list_bp5_files, inspect_variables_handler, @@ -30,7 +30,7 @@ async def test_list_bp5_files_success(self): {"name": "file2.bp5", "size": 2048}, ] - with patch("src.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: + with patch("adios_mcp.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: mock_list_bp5.return_value = mock_files result = await list_bp5_files("/test/directory") @@ -42,7 +42,7 @@ async def test_list_bp5_files_success(self): async def test_list_bp5_files_default_directory(self): mock_files = [] - with patch("src.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: + with patch("adios_mcp.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: mock_list_bp5.return_value = mock_files result = await list_bp5_files() @@ -52,22 +52,15 @@ async def test_list_bp5_files_default_directory(self): @pytest.mark.asyncio async def test_list_bp5_files_exception(self): - with patch("src.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: + with patch("adios_mcp.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: mock_list_bp5.side_effect = FileNotFoundError("Directory not found") - result = await list_bp5_files("/nonexistent") - - assert result["isError"] is True - assert ( - "Directory not found" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "list_bp5" - assert result["_meta"]["error"] == "FileNotFoundError" + with pytest.raises(ToolError, match="Directory not found"): + await list_bp5_files("/nonexistent") @pytest.mark.asyncio async def test_list_bp5_files_empty_result(self): - with patch("src.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: + with patch("adios_mcp.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: mock_list_bp5.return_value = [] result = await list_bp5_files("/empty/dir") @@ -84,14 +77,11 @@ async def test_list_bp5_files_various_exceptions(self): ] for exception_type, message in exception_types: - with patch("src.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: + with patch("adios_mcp.mcp_handlers.bp5_list.list_bp5") as mock_list_bp5: mock_list_bp5.side_effect = exception_type(message) - result = await list_bp5_files("/test") - - assert result["isError"] is True - assert message in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["error"] == exception_type.__name__ + with pytest.raises(ToolError, match=message): + await list_bp5_files("/test") class TestInspectVariablesHandler: @@ -100,7 +90,7 @@ async def test_inspect_variables_handler_no_variable_name(self): mock_result = {"variables": {"temp": {"type": "float64", "shape": [100, 50]}}} with patch( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -114,7 +104,7 @@ async def test_inspect_variables_handler_with_variable_name(self): mock_result = {"variable_data": {"name": "pressure", "values": [1, 2, 3]}} with patch( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -126,42 +116,29 @@ async def test_inspect_variables_handler_with_variable_name(self): @pytest.mark.asyncio async def test_inspect_variables_handler_exception(self): with patch( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) as mock_inspect: mock_inspect.side_effect = Exception("ADIOS inspection failed") - result = await inspect_variables_handler("/test/file.bp") - - assert result["isError"] is True - assert ( - "ADIOS inspection failed" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "inspect_variables" - assert result["_meta"]["error"] == "Exception" + with pytest.raises(ToolError, match="ADIOS inspection failed"): + await inspect_variables_handler("/test/file.bp") @pytest.mark.asyncio async def test_inspect_variables_handler_file_not_found(self): with patch( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) as mock_inspect: mock_inspect.side_effect = FileNotFoundError("BP5 file not found") - result = await inspect_variables_handler("/nonexistent/file.bp") - - assert result["isError"] is True - assert ( - "BP5 file not found" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["error"] == "FileNotFoundError" + with pytest.raises(ToolError, match="BP5 file not found"): + await inspect_variables_handler("/nonexistent/file.bp") @pytest.mark.asyncio async def test_inspect_variables_handler_empty_variable_name(self): mock_result = {"variables": {}} with patch( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -183,7 +160,7 @@ async def test_inspect_variables_at_step_handler_success(self): } with patch( - "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -197,45 +174,29 @@ async def test_inspect_variables_at_step_handler_success(self): @pytest.mark.asyncio async def test_inspect_variables_at_step_handler_exception(self): with patch( - "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" ) as mock_inspect: mock_inspect.side_effect = ValueError("Invalid step number") - result = await inspect_variables_at_step_handler( - "/test/file.bp", "temp", 10 - ) - - assert result["isError"] is True - assert ( - "Invalid step number" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "inspect_variables_at_step" - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="Invalid step number"): + await inspect_variables_at_step_handler("/test/file.bp", "temp", 10) @pytest.mark.asyncio async def test_inspect_variables_at_step_handler_negative_step(self): with patch( - "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" ) as mock_inspect: mock_inspect.side_effect = ValueError("Step must be non-negative") - result = await inspect_variables_at_step_handler( - "/test/file.bp", "temp", -1 - ) - - assert result["isError"] is True - assert ( - "Step must be non-negative" - in json.loads(result["content"][0]["text"])["error"] - ) + with pytest.raises(ToolError, match="Step must be non-negative"): + await inspect_variables_at_step_handler("/test/file.bp", "temp", -1) @pytest.mark.asyncio async def test_inspect_variables_at_step_handler_zero_step(self): mock_result = {"variable": "pressure", "step": 0, "min": 1.0, "max": 10.0} with patch( - "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -251,7 +212,7 @@ async def test_inspect_variables_at_step_handler_large_step(self): mock_result = {"variable": "velocity", "step": 1000, "data_available": True} with patch( - "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -268,7 +229,7 @@ async def test_inspect_attributes_handler_no_variable_name(self): mock_result = {"global_attributes": {"title": "simulation", "version": "1.0"}} with patch( - "src.mcp_handlers.bp5_attributes.inspect_attributes" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -284,7 +245,7 @@ async def test_inspect_attributes_handler_with_variable_name(self): } with patch( - "src.mcp_handlers.bp5_attributes.inspect_attributes" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -296,26 +257,19 @@ async def test_inspect_attributes_handler_with_variable_name(self): @pytest.mark.asyncio async def test_inspect_attributes_handler_exception(self): with patch( - "src.mcp_handlers.bp5_attributes.inspect_attributes" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) as mock_inspect: mock_inspect.side_effect = RuntimeError("Attribute access failed") - result = await inspect_attributes_handler("/test/file.bp") - - assert result["isError"] is True - assert ( - "Attribute access failed" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "inspect_attributes" - assert result["_meta"]["error"] == "RuntimeError" + with pytest.raises(ToolError, match="Attribute access failed"): + await inspect_attributes_handler("/test/file.bp") @pytest.mark.asyncio async def test_inspect_attributes_handler_empty_attributes(self): mock_result = {"attributes": {}} with patch( - "src.mcp_handlers.bp5_attributes.inspect_attributes" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -336,7 +290,7 @@ async def test_inspect_attributes_handler_complex_attributes(self): } with patch( - "src.mcp_handlers.bp5_attributes.inspect_attributes" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) as mock_inspect: mock_inspect.return_value = mock_result @@ -351,7 +305,7 @@ async def test_read_variable_at_step_handler_success(self): mock_value = [1.0, 2.0, 3.0, 4.0, 5.0] with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.return_value = mock_value @@ -365,7 +319,7 @@ async def test_read_variable_at_step_handler_scalar_value(self): mock_value = 42.5 with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.return_value = mock_value @@ -378,59 +332,44 @@ async def test_read_variable_at_step_handler_scalar_value(self): @pytest.mark.asyncio async def test_read_variable_at_step_handler_exception(self): with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.side_effect = Exception("Failed to read variable") - result = await read_variable_at_step_handler("/test/file.bp", "temp", 5) - - assert result["isError"] is True - assert ( - "Failed to read variable" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "read_variable_at_step" - assert result["_meta"]["error"] == "Exception" + with pytest.raises(ToolError, match="Failed to read variable"): + await read_variable_at_step_handler("/test/file.bp", "temp", 5) @pytest.mark.asyncio async def test_read_variable_at_step_handler_file_not_found(self): with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.side_effect = FileNotFoundError("BP5 file not found") - result = await read_variable_at_step_handler( - "/nonexistent/file.bp", "var", 0 - ) - - assert result["isError"] is True - assert result["_meta"]["error"] == "FileNotFoundError" + with pytest.raises(ToolError, match="BP5 file not found"): + await read_variable_at_step_handler("/nonexistent/file.bp", "var", 0) @pytest.mark.asyncio async def test_read_variable_at_step_handler_variable_not_found(self): with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.side_effect = KeyError("Variable 'nonexistent_var' not found") - result = await read_variable_at_step_handler( - "/test/file.bp", "nonexistent_var", 0 - ) - - assert result["isError"] is True - assert result["_meta"]["error"] == "KeyError" + with pytest.raises(ToolError): + await read_variable_at_step_handler( + "/test/file.bp", "nonexistent_var", 0 + ) @pytest.mark.asyncio async def test_read_variable_at_step_handler_step_out_of_range(self): with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.side_effect = IndexError("Step 100 out of range") - result = await read_variable_at_step_handler("/test/file.bp", "temp", 100) - - assert result["isError"] is True - assert result["_meta"]["error"] == "IndexError" + with pytest.raises(ToolError, match="Step 100 out of range"): + await read_variable_at_step_handler("/test/file.bp", "temp", 100) @pytest.mark.asyncio async def test_read_variable_at_step_handler_large_array(self): @@ -438,7 +377,7 @@ async def test_read_variable_at_step_handler_large_array(self): mock_value = list(range(10000)) with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.return_value = mock_value @@ -454,7 +393,7 @@ async def test_read_variable_at_step_handler_empty_array(self): mock_value = [] with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.return_value = mock_value @@ -469,7 +408,7 @@ async def test_read_variable_at_step_handler_none_value(self): mock_value = None with patch( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" ) as mock_read: mock_read.return_value = mock_value @@ -495,8 +434,8 @@ async def test_all_handlers_import_correctly(self): assert hasattr(handler, "__name__") @pytest.mark.asyncio - async def test_error_response_format_consistency(self): - """Test that all handlers return consistent error formats""" + async def test_error_response_raises_tool_error(self): + """Test that all handlers raise ToolError on failure""" handlers_and_args = [ (list_bp5_files, ("/test",)), (inspect_variables_handler, ("/test", None)), @@ -508,29 +447,22 @@ async def test_error_response_format_consistency(self): for handler, args in handlers_and_args: # Mock each handler's underlying implementation to raise an exception if "list_bp5_files" in handler.__name__: - patch_target = "src.mcp_handlers.bp5_list.list_bp5" + patch_target = "adios_mcp.mcp_handlers.bp5_list.list_bp5" elif "inspect_variables_at_step" in handler.__name__: - patch_target = "src.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" + patch_target = "adios_mcp.mcp_handlers.bp5_inspect_variables_at_step.inspect_variables_at_step" elif "inspect_variables" in handler.__name__: patch_target = ( - "src.mcp_handlers.bp5_inspect_variables.inspect_variables" + "adios_mcp.mcp_handlers.bp5_inspect_variables.inspect_variables" ) elif "inspect_attributes" in handler.__name__: - patch_target = "src.mcp_handlers.bp5_attributes.inspect_attributes" - elif "read_variable_at_step" in handler.__name__: patch_target = ( - "src.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" + "adios_mcp.mcp_handlers.bp5_attributes.inspect_attributes" ) + elif "read_variable_at_step" in handler.__name__: + patch_target = "adios_mcp.mcp_handlers.bp5_read_variable_at_step.read_variable_at_step" with patch(patch_target) as mock_impl: mock_impl.side_effect = Exception("Test error") - result = await handler(*args) - - if ( - "isError" in result - ): # Only check error handlers that return error format - assert result["isError"] is True - assert "content" in result - assert "_meta" in result - assert "error" in result["_meta"] + with pytest.raises(ToolError, match="Test error"): + await handler(*args) diff --git a/clio-kit-mcp-servers/adios/tests/test_server.py b/clio-kit-mcp-servers/adios/tests/test_server.py index 08db092f..d929c25f 100644 --- a/clio-kit-mcp-servers/adios/tests/test_server.py +++ b/clio-kit-mcp-servers/adios/tests/test_server.py @@ -1,13 +1,13 @@ import pytest -import json import os from unittest.mock import AsyncMock, patch, MagicMock +from fastmcp.exceptions import ToolError class TestServerToolFunctions: @pytest.mark.asyncio async def test_list_bp5_tool_success(self): - from src.server import list_bp5_tool + from adios_mcp.server import list_bp5_tool mock_files = [ {"name": "file1.bp", "size": 1024}, @@ -15,272 +15,197 @@ async def test_list_bp5_tool_success(self): ] with patch( - "src.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = {"files": mock_files} - # Access the actual function from the FunctionTool - actual_func = ( - list_bp5_tool.fn if hasattr(list_bp5_tool, "fn") else list_bp5_tool - ) - result = await actual_func("/test/directory") + result = await list_bp5_tool("/test/directory") mock_handler.assert_called_once_with("/test/directory") assert result == {"files": mock_files} @pytest.mark.asyncio async def test_list_bp5_tool_exception(self): - from src.server import list_bp5_tool + from adios_mcp.server import list_bp5_tool with patch( - "src.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock ) as mock_handler: - mock_handler.side_effect = FileNotFoundError("Directory not found") - - actual_func = ( - list_bp5_tool.fn if hasattr(list_bp5_tool, "fn") else list_bp5_tool - ) - result = await actual_func("/nonexistent") + mock_handler.side_effect = ToolError("Directory not found") - assert result["isError"] is True - assert ( - "Directory not found" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "list_bp5" - assert result["_meta"]["error"] == "FileNotFoundError" + with pytest.raises(ToolError, match="Directory not found"): + await list_bp5_tool("/nonexistent") @pytest.mark.asyncio async def test_list_bp5_tool_default_directory(self): - from src.server import list_bp5_tool + from adios_mcp.server import list_bp5_tool with patch( - "src.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.list_bp5_files", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = {"files": []} - actual_func = ( - list_bp5_tool.fn if hasattr(list_bp5_tool, "fn") else list_bp5_tool - ) - result = await actual_func() + result = await list_bp5_tool() mock_handler.assert_called_once_with("data/") assert result == {"files": []} @pytest.mark.asyncio async def test_inspect_variables_tool_success(self): - from src.server import inspect_variables_tool + from adios_mcp.server import inspect_variables_tool mock_result = {"variables": {"temp": {"type": "float64", "shape": [100, 50]}}} with patch( - "src.server.mcp_handlers.inspect_variables_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_variables_handler", + new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - inspect_variables_tool.fn - if hasattr(inspect_variables_tool, "fn") - else inspect_variables_tool - ) - result = await actual_func("/test/file.bp") + result = await inspect_variables_tool("/test/file.bp") mock_handler.assert_called_once_with("/test/file.bp", None) assert result == mock_result @pytest.mark.asyncio async def test_inspect_variables_tool_with_variable_name(self): - from src.server import inspect_variables_tool + from adios_mcp.server import inspect_variables_tool mock_result = {"variable_data": {"name": "pressure", "values": [1, 2, 3]}} with patch( - "src.server.mcp_handlers.inspect_variables_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_variables_handler", + new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - inspect_variables_tool.fn - if hasattr(inspect_variables_tool, "fn") - else inspect_variables_tool - ) - result = await actual_func("/test/file.bp", "pressure") + result = await inspect_variables_tool("/test/file.bp", "pressure") mock_handler.assert_called_once_with("/test/file.bp", "pressure") assert result == mock_result @pytest.mark.asyncio async def test_inspect_variables_tool_exception(self): - from src.server import inspect_variables_tool + from adios_mcp.server import inspect_variables_tool with patch( - "src.server.mcp_handlers.inspect_variables_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_variables_handler", + new_callable=AsyncMock, ) as mock_handler: - mock_handler.side_effect = Exception("ADIOS error") - - actual_func = ( - inspect_variables_tool.fn - if hasattr(inspect_variables_tool, "fn") - else inspect_variables_tool - ) - result = await actual_func("/test/file.bp") + mock_handler.side_effect = ToolError("ADIOS error") - assert result["isError"] is True - assert "ADIOS error" in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["tool"] == "inspect_variables" + with pytest.raises(ToolError, match="ADIOS error"): + await inspect_variables_tool("/test/file.bp") @pytest.mark.asyncio async def test_inspect_variables_at_step_tool_success(self): - from src.server import inspect_variables_at_step_tool + from adios_mcp.server import inspect_variables_at_step_tool mock_result = {"variable": "temp", "step": 5, "shape": [100], "type": "float64"} with patch( - "src.server.mcp_handlers.inspect_variables_at_step_handler", + "adios_mcp.server.mcp_handlers.inspect_variables_at_step_handler", new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - inspect_variables_at_step_tool.fn - if hasattr(inspect_variables_at_step_tool, "fn") - else inspect_variables_at_step_tool - ) - result = await actual_func("/test/file.bp", "temp", 5) + result = await inspect_variables_at_step_tool("/test/file.bp", "temp", 5) mock_handler.assert_called_once_with("/test/file.bp", "temp", 5) assert result == mock_result @pytest.mark.asyncio async def test_inspect_variables_at_step_tool_exception(self): - from src.server import inspect_variables_at_step_tool + from adios_mcp.server import inspect_variables_at_step_tool with patch( - "src.server.mcp_handlers.inspect_variables_at_step_handler", + "adios_mcp.server.mcp_handlers.inspect_variables_at_step_handler", new_callable=AsyncMock, ) as mock_handler: - mock_handler.side_effect = ValueError("Invalid step") - - actual_func = ( - inspect_variables_at_step_tool.fn - if hasattr(inspect_variables_at_step_tool, "fn") - else inspect_variables_at_step_tool - ) - result = await actual_func("/test/file.bp", "temp", 10) + mock_handler.side_effect = ToolError("Invalid step") - assert result["isError"] is True - assert "Invalid step" in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["tool"] == "inspect_variables_at_step" - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="Invalid step"): + await inspect_variables_at_step_tool("/test/file.bp", "temp", 10) @pytest.mark.asyncio async def test_inspect_attributes_tool_success(self): - from src.server import inspect_attributes_tool + from adios_mcp.server import inspect_attributes_tool mock_result = { "attributes": {"global": {"title": "simulation"}, "variables": {}} } with patch( - "src.server.mcp_handlers.inspect_attributes_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_attributes_handler", + new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - inspect_attributes_tool.fn - if hasattr(inspect_attributes_tool, "fn") - else inspect_attributes_tool - ) - result = await actual_func("/test/file.bp") + result = await inspect_attributes_tool("/test/file.bp") mock_handler.assert_called_once_with("/test/file.bp", None) assert result == mock_result @pytest.mark.asyncio async def test_inspect_attributes_tool_with_variable(self): - from src.server import inspect_attributes_tool + from adios_mcp.server import inspect_attributes_tool mock_result = {"attributes": {"variable_attrs": {"units": "celsius"}}} with patch( - "src.server.mcp_handlers.inspect_attributes_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_attributes_handler", + new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - inspect_attributes_tool.fn - if hasattr(inspect_attributes_tool, "fn") - else inspect_attributes_tool - ) - result = await actual_func("/test/file.bp", "temperature") + result = await inspect_attributes_tool("/test/file.bp", "temperature") mock_handler.assert_called_once_with("/test/file.bp", "temperature") assert result == mock_result @pytest.mark.asyncio async def test_inspect_attributes_tool_exception(self): - from src.server import inspect_attributes_tool + from adios_mcp.server import inspect_attributes_tool with patch( - "src.server.mcp_handlers.inspect_attributes_handler", new_callable=AsyncMock + "adios_mcp.server.mcp_handlers.inspect_attributes_handler", + new_callable=AsyncMock, ) as mock_handler: - mock_handler.side_effect = RuntimeError("Attribute access failed") + mock_handler.side_effect = ToolError("Attribute access failed") - actual_func = ( - inspect_attributes_tool.fn - if hasattr(inspect_attributes_tool, "fn") - else inspect_attributes_tool - ) - result = await actual_func("/test/file.bp") - - assert result["isError"] is True - assert ( - "Attribute access failed" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["tool"] == "inspect_attributes" - assert result["_meta"]["error"] == "RuntimeError" + with pytest.raises(ToolError, match="Attribute access failed"): + await inspect_attributes_tool("/test/file.bp") @pytest.mark.asyncio async def test_read_variable_at_step_tool_success(self): - from src.server import read_variable_at_step_tool + from adios_mcp.server import read_variable_at_step_tool mock_result = {"value": [1.0, 2.0, 3.0]} with patch( - "src.server.mcp_handlers.read_variable_at_step_handler", + "adios_mcp.server.mcp_handlers.read_variable_at_step_handler", new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - read_variable_at_step_tool.fn - if hasattr(read_variable_at_step_tool, "fn") - else read_variable_at_step_tool - ) - result = await actual_func("/test/file.bp", "pressure", 3) + result = await read_variable_at_step_tool("/test/file.bp", "pressure", 3) mock_handler.assert_called_once_with("/test/file.bp", "pressure", 3) assert result == mock_result @pytest.mark.asyncio async def test_read_variable_at_step_tool_scalar_value(self): - from src.server import read_variable_at_step_tool + from adios_mcp.server import read_variable_at_step_tool mock_result = {"value": 42.5} with patch( - "src.server.mcp_handlers.read_variable_at_step_handler", + "adios_mcp.server.mcp_handlers.read_variable_at_step_handler", new_callable=AsyncMock, ) as mock_handler: mock_handler.return_value = mock_result - actual_func = ( - read_variable_at_step_tool.fn - if hasattr(read_variable_at_step_tool, "fn") - else read_variable_at_step_tool - ) - result = await actual_func("/test/file.bp", "scalar_var", 0) + result = await read_variable_at_step_tool("/test/file.bp", "scalar_var", 0) mock_handler.assert_called_once_with("/test/file.bp", "scalar_var", 0) assert result == mock_result @@ -288,138 +213,138 @@ async def test_read_variable_at_step_tool_scalar_value(self): class TestMainFunction: def test_main_default_stdio_transport(self): - from src.server import main + from adios_mcp.server import main mock_mcp = MagicMock() - with patch("src.server.mcp", mock_mcp), patch.dict(os.environ, {}, clear=True): + with ( + patch("adios_mcp.server.mcp", mock_mcp), + patch("sys.argv", ["adios-mcp"]), + patch.dict(os.environ, {}, clear=True), + ): main() mock_mcp.run.assert_called_once_with(transport="stdio") - def test_main_sse_transport_default_host_port(self): - from src.server import main + def test_main_http_transport_via_args(self): + from adios_mcp.server import main mock_mcp = MagicMock() with ( - patch("src.server.mcp", mock_mcp), - patch.dict(os.environ, {"MCP_TRANSPORT": "sse"}, clear=True), - patch("builtins.print") as mock_print, + patch("adios_mcp.server.mcp", mock_mcp), + patch("sys.argv", ["adios-mcp", "--transport", "http"]), ): main() mock_mcp.run.assert_called_once_with( - transport="sse", host="0.0.0.0", port=8000 + transport="http", host="0.0.0.0", port=8000 ) - mock_print.assert_called() - def test_main_sse_transport_custom_host_port(self): - from src.server import main + def test_main_custom_host_port_via_args(self): + from adios_mcp.server import main mock_mcp = MagicMock() with ( - patch("src.server.mcp", mock_mcp), - patch.dict( - os.environ, - { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "localhost", - "MCP_SSE_PORT": "9000", - }, - clear=True, + patch("adios_mcp.server.mcp", mock_mcp), + patch( + "sys.argv", + [ + "adios-mcp", + "--transport", + "http", + "--host", + "localhost", + "--port", + "9000", + ], ), - patch("builtins.print") as mock_print, ): main() mock_mcp.run.assert_called_once_with( - transport="sse", host="localhost", port=9000 + transport="http", host="localhost", port=9000 ) - mock_print.assert_called() def test_main_stdio_transport_explicit(self): - from src.server import main + from adios_mcp.server import main mock_mcp = MagicMock() with ( - patch("src.server.mcp", mock_mcp), - patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}, clear=True), + patch("adios_mcp.server.mcp", mock_mcp), + patch("sys.argv", ["adios-mcp", "--transport", "stdio"]), ): main() mock_mcp.run.assert_called_once_with(transport="stdio") - def test_main_exception_handling(self): - from src.server import main - - mock_mcp = MagicMock() - mock_mcp.run.side_effect = RuntimeError("Server startup failed") - - with ( - patch("src.server.mcp", mock_mcp), - patch.dict(os.environ, {}, clear=True), - patch("builtins.print") as mock_print, - patch("sys.exit") as mock_exit, - ): - main() - - mock_print.assert_called() - mock_exit.assert_called_once_with(1) - - def test_main_case_insensitive_transport(self): - from src.server import main + def test_main_transport_from_env(self): + from adios_mcp.server import main mock_mcp = MagicMock() with ( - patch("src.server.mcp", mock_mcp), - patch.dict(os.environ, {"MCP_TRANSPORT": "SSE"}, clear=True), - patch("builtins.print"), + patch("adios_mcp.server.mcp", mock_mcp), + patch("sys.argv", ["adios-mcp"]), + patch.dict(os.environ, {"MCP_TRANSPORT": "http"}, clear=True), ): main() mock_mcp.run.assert_called_once_with( - transport="sse", host="0.0.0.0", port=8000 + transport="http", host="0.0.0.0", port=8000 ) - def test_main_invalid_port_handling(self): - from src.server import main + def test_main_args_override_env(self): + from adios_mcp.server import main mock_mcp = MagicMock() with ( - patch("src.server.mcp", mock_mcp), - patch.dict( - os.environ, - {"MCP_TRANSPORT": "sse", "MCP_SSE_PORT": "invalid_port"}, - clear=True, - ), - patch("builtins.print") as mock_print, - patch("sys.exit") as mock_exit, + patch("adios_mcp.server.mcp", mock_mcp), + patch("sys.argv", ["adios-mcp", "--transport", "stdio"]), + patch.dict(os.environ, {"MCP_TRANSPORT": "http"}, clear=True), ): main() - mock_print.assert_called() - mock_exit.assert_called_once_with(1) + mock_mcp.run.assert_called_once_with(transport="stdio") class TestServerIntegration: def test_server_imports(self): """Test that all required modules are properly imported""" - import src.server as server + import adios_mcp.server as server assert hasattr(server, "FastMCP") assert hasattr(server, "mcp_handlers") assert hasattr(server, "mcp") - def test_environment_variable_loading(self): - """Test that dotenv loading works properly""" - # Since load_dotenv is called at module import time, we need to test - # that it's available and can be called - from dotenv import load_dotenv + def test_server_has_tool_error_import(self): + """Test that ToolError is properly imported""" + import adios_mcp.server as server + + assert hasattr(server, "ToolError") + + def test_server_has_message_import(self): + """Test that Message is properly imported""" + import adios_mcp.server as server + + assert hasattr(server, "Message") + + def test_server_has_resource(self): + """Test that the adios_capabilities resource is defined""" + from adios_mcp.server import adios_capabilities + + result = adios_capabilities() + assert "supported_formats" in result + assert "BP4" in result["supported_formats"] + assert "BP5" in result["supported_formats"] + + def test_server_has_prompt(self): + """Test that the explore_bp_file prompt is defined""" + from adios_mcp.server import explore_bp_file - # Just test that the function exists and is callable - assert callable(load_dotenv) + messages = explore_bp_file("/test/file.bp") + assert len(messages) == 1 + assert "/test/file.bp" in messages[0].content.text diff --git a/clio-kit-mcp-servers/adios/uv.lock b/clio-kit-mcp-servers/adios/uv.lock index 63a422b3..af6d0abd 100644 --- a/clio-kit-mcp-servers/adios/uv.lock +++ b/clio-kit-mcp-servers/adios/uv.lock @@ -25,7 +25,7 @@ dev = [ [package.metadata] requires-dist = [ { name = "adios2" }, - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "h11", specifier = ">=0.16.0" }, { name = "numpy" }, ] @@ -478,27 +478,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -622,6 +628,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -696,7 +711,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -710,11 +725,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -863,6 +880,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -919,15 +949,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -942,19 +972,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -1639,16 +1656,119 @@ wheels = [ [[package]] name = "uvicorn" -version = "0.34.0" +version = "0.41.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "click" }, { name = "h11" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/4b/4d/938bd85e5bf2edeec766267a5015ad969730bb91e31b44021dfe8b22df6c/uvicorn-0.34.0.tar.gz", hash = "sha256:404051050cd7e905de2c9a7e61790943440b3416f49cb409f965d9dcd0fa73e9", size = 76568, upload-time = "2024-12-15T13:33:30.42Z" } +sdist = { url = "https://files.pythonhosted.org/packages/32/ce/eeb58ae4ac36fe09e3842eb02e0eb676bf2c53ae062b98f1b2531673efdd/uvicorn-0.41.0.tar.gz", hash = "sha256:09d11cf7008da33113824ee5a1c6422d89fbc2ff476540d69a34c87fab8b571a", size = 82633, upload-time = "2026-02-16T23:07:24.1Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/61/14/33a3a1352cfa71812a3a21e8c9bfb83f60b0011f5e36f2b1399d51928209/uvicorn-0.34.0-py3-none-any.whl", hash = "sha256:023dc038422502fa28a09c7a30bf2b6991512da7dcdb8fd35fe57cfc154126f4", size = 62315, upload-time = "2024-12-15T13:33:27.467Z" }, + { url = "https://files.pythonhosted.org/packages/83/e4/d04a086285c20886c0daad0e026f250869201013d18f81d9ff5eada73a88/uvicorn-0.41.0-py3-none-any.whl", hash = "sha256:29e35b1d2c36a04b9e180d4007ede3bcb32a85fbdfd6c6aeb3f26839de088187", size = 68783, upload-time = "2026-02-16T23:07:22.357Z" }, +] + +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, ] [[package]] diff --git a/clio-kit-mcp-servers/arxiv/.claude-plugin/plugin.json b/clio-kit-mcp-servers/arxiv/.claude-plugin/plugin.json new file mode 100644 index 00000000..1a4d0209 --- /dev/null +++ b/clio-kit-mcp-servers/arxiv/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-arxiv", + "description": "ArXiv MCP server implementation using Model Context Protocol", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/arxiv/.mcp.json b/clio-kit-mcp-servers/arxiv/.mcp.json new file mode 100644 index 00000000..d6b8e116 --- /dev/null +++ b/clio-kit-mcp-servers/arxiv/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-arxiv": { + "command": "uvx", + "args": [ + "clio-kit", + "arxiv" + ] + } +} diff --git a/clio-kit-mcp-servers/arxiv/README.md b/clio-kit-mcp-servers/arxiv/README.md index ffe464bd..168b847d 100644 --- a/clio-kit-mcp-servers/arxiv/README.md +++ b/clio-kit-mcp-servers/arxiv/README.md @@ -142,121 +142,129 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\arxiv run arxiv-mcp ## Capabilities ### `search_arxiv` -**Description**: Search ArXiv for research papers by category or topic with comprehensive filtering and ranking capabilities. - -**Parameters**: -- `query` (str, optional): Search query or category (default: "cs.AI") -- `max_results` (int, optional): Maximum number of results to return (default: 5) - -**Returns**: Dictionary with search results including paper metadata, abstracts, and ArXiv identifiers. +**Description**: Search ArXiv for papers by category or topic. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `get_recent_papers` -**Description**: Get recent papers from a specific ArXiv category with chronological ordering and metadata extraction. - -**Parameters**: -- `category` (str, optional): ArXiv category (default: "cs.AI") -- `max_results` (int, optional): Maximum number of results to return (default: 5) - -**Returns**: Dictionary with recent papers including publication dates, authors, and paper summaries. +**Description**: Get recent papers from a specific ArXiv category. +**Hints**: read-only, idempotent +**Tags**: arxiv, papers ### `search_papers_by_author` -**Description**: Search ArXiv papers by author name with comprehensive author matching and publication history. - -**Parameters**: -- `author` (str): Author name to search for -- `max_results` (int, optional): Maximum number of results to return (default: 10) - -**Returns**: Dictionary with author's papers including co-authors, publication timeline, and research areas. +**Description**: Search ArXiv papers by author name. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `search_by_title` -**Description**: Search ArXiv papers by title keywords with intelligent keyword matching and relevance scoring. - -**Parameters**: -- `title_keywords` (str): Keywords to search in paper titles -- `max_results` (int, optional): Maximum number of results to return (default: 10) - -**Returns**: Dictionary with search results ranked by title relevance and keyword matching. +**Description**: Search ArXiv papers by title keywords. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `search_by_abstract` -**Description**: Search ArXiv papers by abstract keywords with semantic content analysis and relevance ranking. - -**Parameters**: -- `abstract_keywords` (str): Keywords to search in paper abstracts -- `max_results` (int, optional): Maximum number of results to return (default: 10) - -**Returns**: Dictionary with papers matching abstract content with relevance scores and keyword highlights. +**Description**: Search ArXiv papers by abstract keywords. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `search_by_subject` -**Description**: Search ArXiv papers by subject classification with comprehensive category-based filtering. - -**Parameters**: -- `subject` (str): ArXiv subject classification (e.g., 'cs.AI', 'physics.astro-ph') -- `max_results` (int, optional): Maximum number of results to return (default: 10) - -**Returns**: Dictionary with papers from specified subject areas with classification metadata. +**Description**: Search ArXiv papers by subject classification. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `search_date_range` -**Description**: Search ArXiv papers within a specific date range with optional category filtering and chronological organization. - -**Parameters**: -- `start_date` (str): Start date in YYYY-MM-DD format -- `end_date` (str): End date in YYYY-MM-DD format -- `category` (str, optional, optional): Optional category filter (e.g., 'cs.AI') -- `max_results` (int, optional): Maximum number of results to return (default: 20) - -**Returns**: Dictionary with papers published within date range with temporal metadata and category information. +**Description**: Search ArXiv papers within a specific date range. +**Hints**: read-only, idempotent +**Tags**: arxiv, search ### `get_paper_details` -**Description**: Get detailed information about a specific ArXiv paper by ID with comprehensive metadata extraction. +**Description**: Get detailed information about a specific ArXiv paper by ID. +**Hints**: read-only, idempotent +**Tags**: arxiv, papers -**Parameters**: -- `arxiv_id` (str): ArXiv paper ID (e.g., '2301.12345' or 'cs/0501001') +### `export_to_bibtex` +**Description**: Export search results to BibTeX format for citation management. +**Hints**: read-only, idempotent +**Tags**: arxiv, export -**Returns**: Dictionary with detailed paper information including full abstract, authors, categories, and publication data. +### `find_similar_papers` +**Description**: Find papers similar to a reference paper based on categories and keywords. +**Hints**: read-only, idempotent +**Tags**: arxiv, search -### `export_to_bibtex` -**Description**: Export search results to BibTeX format for citation management and bibliography generation. +### `download_paper_pdf` +**Description**: Download the PDF of a paper from ArXiv. +**Hints**: read-only, idempotent +**Tags**: arxiv, download -**Parameters**: -- `papers_json` (str): JSON string containing list of papers to export +### `get_pdf_url` +**Description**: Get the direct PDF URL for a paper without downloading. +**Hints**: read-only, idempotent +**Tags**: arxiv, papers -**Returns**: Dictionary with BibTeX citations properly formatted for academic reference management. +### `download_multiple_pdfs` +**Description**: Download multiple PDFs concurrently with rate limiting. +**Hints**: read-only, idempotent +**Tags**: arxiv, download -### `find_similar_papers` -**Description**: Find papers similar to a reference paper based on categories, keywords, and content analysis. +### Resources -**Parameters**: -- `reference_paper_id` (str): ArXiv ID of the reference paper -- `max_results` (int, optional): Maximum number of similar papers to return (default: 10) +- `arxiv://categories` - Common arXiv subject categories and their descriptions. -**Returns**: Dictionary with similar papers ranked by relevance with similarity scores and matching criteria. +### Prompts -### `download_paper_pdf` -**Description**: Download the PDF of a paper from ArXiv with automatic file management and error handling. +- **literature_search**: Guided workflow for conducting an arXiv literature search. +## Claude Code -**Parameters**: -- `arxiv_id` (str): ArXiv paper ID (e.g., '2301.12345' or 'cs/0501001') -- `download_path` (str, optional, optional): Optional path to save the PDF +```bash +claude mcp add clio-arxiv -- uvx clio-kit arxiv +``` -**Returns**: Dictionary with download information. +Or install via the CLIO Kit plugin marketplace: -### `get_pdf_url` -**Description**: Get PDF URL for an ArXiv paper. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-arxiv@iowarp-clio-kit +``` +## Claude Desktop -**Parameters**: -- `arxiv_id` (str): Parameter for arxiv_id +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Returns**: Dictionary with PDF URL information +```json +{ + "mcpServers": { + "clio-arxiv": { + "command": "uvx", + "args": [ + "clio-kit", + "arxiv" + ] + } + } +} +``` +## Gemini CLI -### `download_multiple_pdfs` -**Description**: Download multiple PDFs concurrently. +Add to `~/.gemini/settings.json`: -**Parameters**: -- `arxiv_ids_json` (str): Parameter for arxiv_ids_json -- `download_path` (Any, optional): Parameter for download_path -- `max_concurrent` (int, optional): Parameter for max_concurrent (default: 3) +```json +{ + "mcpServers": { + "clio-arxiv": { + "command": "uvx", + "args": [ + "clio-kit", + "arxiv" + ] + } + } +} +``` + +Or install the CLIO Kit extension: -**Returns**: Dictionary with download results +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Academic Research Discovery diff --git a/clio-kit-mcp-servers/arxiv/pyproject.toml b/clio-kit-mcp-servers/arxiv/pyproject.toml index bc7b2521..2fafbf81 100644 --- a/clio-kit-mcp-servers/arxiv/pyproject.toml +++ b/clio-kit-mcp-servers/arxiv/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["data processing", "arxiv", "publications", "scientific data", "research", "papers", "iowarp", "grc"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "httpx>=0.24.0", ] @@ -21,7 +21,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -arxiv-mcp = "server:main" +arxiv-mcp = "arxiv_mcp.server:main" [dependency-groups] dev = [ @@ -33,5 +33,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/arxiv_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/arxiv/server.json b/clio-kit-mcp-servers/arxiv/server.json new file mode 100644 index 00000000..dac20ee1 --- /dev/null +++ b/clio-kit-mcp-servers/arxiv/server.json @@ -0,0 +1,87 @@ +{ + "name": "io.github.iowarp/arxiv-mcp", + "description": "ArXiv MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "arxiv" + ] + }, + "tools": [ + { + "name": "search_arxiv", + "description": "Search ArXiv for papers by category or topic." + }, + { + "name": "get_recent_papers", + "description": "Get recent papers from a specific ArXiv category." + }, + { + "name": "search_papers_by_author", + "description": "Search ArXiv papers by author name." + }, + { + "name": "search_by_title", + "description": "Search ArXiv papers by title keywords." + }, + { + "name": "search_by_abstract", + "description": "Search ArXiv papers by abstract keywords." + }, + { + "name": "search_by_subject", + "description": "Search ArXiv papers by subject classification." + }, + { + "name": "search_date_range", + "description": "Search ArXiv papers within a specific date range." + }, + { + "name": "get_paper_details", + "description": "Get detailed information about a specific ArXiv paper by ID." + }, + { + "name": "export_to_bibtex", + "description": "Export search results to BibTeX format for citation management." + }, + { + "name": "find_similar_papers", + "description": "Find papers similar to a reference paper based on categories and keywords." + }, + { + "name": "download_paper_pdf", + "description": "Download the PDF of a paper from ArXiv." + }, + { + "name": "get_pdf_url", + "description": "Get the direct PDF URL for a paper without downloading." + }, + { + "name": "download_multiple_pdfs", + "description": "Download multiple PDFs concurrently with rate limiting." + } + ], + "resources": [ + { + "uri": "arxiv://categories", + "name": "arxiv_categories", + "description": "Common arXiv subject categories and their descriptions." + } + ], + "prompts": [ + { + "name": "literature_search", + "description": "Guided workflow for conducting an arXiv literature search." + } + ], + "tags": [ + "research", + "arxiv", + "papers", + "literature-search" + ] +} diff --git a/clio-kit-mcp-servers/arxiv/src/__init__.py b/clio-kit-mcp-servers/arxiv/src/__init__.py deleted file mode 100644 index cfa0ec13..00000000 --- a/clio-kit-mcp-servers/arxiv/src/__init__.py +++ /dev/null @@ -1,4 +0,0 @@ -""" -ArXiv MCP Server -A Model Context Protocol server for fetching research papers from ArXiv. -""" diff --git a/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/__init__.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/__init__.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/__init__.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/__init__.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/__init__.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/arxiv_base.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/arxiv_base.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/arxiv_base.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/arxiv_base.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/category_search.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/category_search.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/category_search.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/category_search.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/date_search.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/date_search.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/date_search.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/date_search.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/download_paper.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/download_paper.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/download_paper.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/download_paper.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/export_utils.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/export_utils.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/export_utils.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/export_utils.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/paper_details.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/paper_details.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/paper_details.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/paper_details.py diff --git a/clio-kit-mcp-servers/arxiv/src/capabilities/text_search.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/text_search.py similarity index 100% rename from clio-kit-mcp-servers/arxiv/src/capabilities/text_search.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/capabilities/text_search.py diff --git a/clio-kit-mcp-servers/arxiv/src/mcp_handlers.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/mcp_handlers.py similarity index 97% rename from clio-kit-mcp-servers/arxiv/src/mcp_handlers.py rename to clio-kit-mcp-servers/arxiv/src/arxiv_mcp/mcp_handlers.py index 6ad1a5c6..4345692e 100644 --- a/clio-kit-mcp-servers/arxiv/src/mcp_handlers.py +++ b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/mcp_handlers.py @@ -5,20 +5,20 @@ import json from typing import Dict, Any, Optional -from capabilities.category_search import ( +from .capabilities.category_search import ( search_arxiv, get_recent_papers, search_by_subject, ) -from capabilities.text_search import ( +from .capabilities.text_search import ( search_by_title, search_by_abstract, search_papers_by_author, ) -from capabilities.date_search import search_date_range -from capabilities.paper_details import get_paper_details, find_similar_papers -from capabilities.export_utils import export_to_bibtex -from capabilities.download_paper import ( +from .capabilities.date_search import search_date_range +from .capabilities.paper_details import get_paper_details, find_similar_papers +from .capabilities.export_utils import export_to_bibtex +from .capabilities.download_paper import ( download_paper_pdf, get_pdf_url, download_multiple_pdfs, diff --git a/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/server.py b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/server.py new file mode 100644 index 00000000..f60aeb86 --- /dev/null +++ b/clio-kit-mcp-servers/arxiv/src/arxiv_mcp/server.py @@ -0,0 +1,300 @@ +#!/usr/bin/env python3 +""" +ArXiv MCP Server implementation using Model Context Protocol. +Provides access to ArXiv research papers through search and retrieval tools. +""" + +import os +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +from dotenv import load_dotenv +import logging +from typing import Optional +from . import mcp_handlers + +# Configure logging +logging.basicConfig( + level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" +) +logger = logging.getLogger(__name__) + +# Load environment variables +load_dotenv() + +# Initialize MCP server +mcp: FastMCP = FastMCP( + "arxiv", + instructions=( + "Searches and retrieves academic papers from arXiv. " + "Search by keyword, author, title, or subject. Fetch paper details and abstracts." + ), + list_page_size=10, +) + +_READONLY_ANNOTATIONS = { + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, +} + + +@mcp.tool( + name="search_arxiv", + description="Search ArXiv for papers by category or topic.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_arxiv_tool(query: str = "cs.AI", max_results: int = 5) -> dict: + """Search ArXiv for research papers by category or topic.""" + logger.info(f"Searching ArXiv for query: {query}") + try: + return await mcp_handlers.search_arxiv_handler(query, max_results) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="get_recent_papers", + description="Get recent papers from a specific ArXiv category.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "papers"}, +) +async def get_recent_papers_tool(category: str = "cs.AI", max_results: int = 5) -> dict: + """Get recent papers from a specific ArXiv category.""" + logger.info(f"Getting recent papers from category: {category}") + try: + return await mcp_handlers.get_recent_papers_handler(category, max_results) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="search_papers_by_author", + description="Search ArXiv papers by author name.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_papers_by_author_tool(author: str, max_results: int = 10) -> dict: + """Search ArXiv papers by author name.""" + logger.info(f"Searching papers by author: {author}") + try: + return await mcp_handlers.search_papers_by_author_handler(author, max_results) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="search_by_title", + description="Search ArXiv papers by title keywords.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_by_title_tool(title_keywords: str, max_results: int = 10) -> dict: + """Search ArXiv papers by title keywords.""" + logger.info(f"Searching papers by title: {title_keywords}") + try: + return await mcp_handlers.search_by_title_handler(title_keywords, max_results) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="search_by_abstract", + description="Search ArXiv papers by abstract keywords.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_by_abstract_tool( + abstract_keywords: str, max_results: int = 10 +) -> dict: + """Search ArXiv papers by abstract keywords.""" + logger.info(f"Searching papers by abstract: {abstract_keywords}") + try: + return await mcp_handlers.search_by_abstract_handler( + abstract_keywords, max_results + ) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="search_by_subject", + description="Search ArXiv papers by subject classification.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_by_subject_tool(subject: str, max_results: int = 10) -> dict: + """Search ArXiv papers by subject classification.""" + logger.info(f"Searching papers by subject: {subject}") + try: + return await mcp_handlers.search_by_subject_handler(subject, max_results) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="search_date_range", + description="Search ArXiv papers within a specific date range.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def search_date_range_tool( + start_date: str, end_date: str, category: str = "", max_results: int = 20 +) -> dict: + """Search ArXiv papers within a date range, optionally filtered by category.""" + logger.info(f"Searching papers by date range: {start_date} to {end_date}") + try: + return await mcp_handlers.search_date_range_handler( + start_date, end_date, category, max_results + ) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="get_paper_details", + description="Get detailed information about a specific ArXiv paper by ID.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "papers"}, +) +async def get_paper_details_tool(arxiv_id: str) -> dict: + """Get detailed information about a specific ArXiv paper by ID.""" + logger.info(f"Getting paper details for: {arxiv_id}") + try: + return await mcp_handlers.get_paper_details_handler(arxiv_id) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="export_to_bibtex", + description="Export search results to BibTeX format for citation management.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "export"}, +) +async def export_to_bibtex_tool(papers_json: str) -> dict: + """Export search results to BibTeX format.""" + logger.info("Exporting papers to BibTeX format") + try: + return await mcp_handlers.export_to_bibtex_handler(papers_json) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="find_similar_papers", + description="Find papers similar to a reference paper based on categories and keywords.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "search"}, +) +async def find_similar_papers_tool( + reference_paper_id: str, max_results: int = 10 +) -> dict: + """Find papers similar to a reference paper.""" + logger.info(f"Finding papers similar to: {reference_paper_id}") + try: + return await mcp_handlers.find_similar_papers_handler( + reference_paper_id, max_results + ) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="download_paper_pdf", + description="Download the PDF of a paper from ArXiv.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "download"}, +) +async def download_paper_pdf_tool( + arxiv_id: str, download_path: Optional[str] = None +) -> dict: + """Download the PDF of a paper from ArXiv.""" + logger.info(f"Downloading PDF for paper: {arxiv_id}") + try: + return await mcp_handlers.download_paper_pdf_handler(arxiv_id, download_path) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="get_pdf_url", + description="Get the direct PDF URL for a paper without downloading.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "papers"}, +) +async def get_pdf_url_tool(arxiv_id: str) -> dict: + """Get the direct PDF URL for an ArXiv paper.""" + logger.info(f"Getting PDF URL for paper: {arxiv_id}") + try: + return await mcp_handlers.get_pdf_url_handler(arxiv_id) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.tool( + name="download_multiple_pdfs", + description="Download multiple PDFs concurrently with rate limiting.", + annotations=_READONLY_ANNOTATIONS, + tags={"arxiv", "download"}, +) +async def download_multiple_pdfs_tool( + arxiv_ids_json: str, download_path: str | None = None, max_concurrent: int = 3 +) -> dict: + """Download multiple PDFs concurrently.""" + logger.info(f"Downloading multiple PDFs with max_concurrent: {max_concurrent}") + try: + return await mcp_handlers.download_multiple_pdfs_handler( + arxiv_ids_json, download_path, max_concurrent + ) + except Exception as e: + raise ToolError(str(e)) from e + + +@mcp.resource("arxiv://categories") +def arxiv_categories() -> dict: + """Common arXiv subject categories and their descriptions.""" + return { + "categories": { + "cs.AI": "Artificial Intelligence", + "cs.LG": "Machine Learning", + "cs.CL": "Computation and Language", + "physics.comp-ph": "Computational Physics", + "math.NA": "Numerical Analysis", + "stat.ML": "Machine Learning (Statistics)", + } + } + + +@mcp.prompt() +def literature_search(topic: str) -> list[Message]: + """Guided workflow for conducting an arXiv literature search.""" + return [ + Message( + f"I need to find recent papers on '{topic}'. " + "Search arXiv, show the top 5 results with titles, authors, and abstracts, " + "and highlight the most cited or recent paper." + ), + ] + + +def main() -> None: + """Main entry point for the ArXiv MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="ArXiv MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/arxiv/src/server.py b/clio-kit-mcp-servers/arxiv/src/server.py deleted file mode 100644 index 919d2fec..00000000 --- a/clio-kit-mcp-servers/arxiv/src/server.py +++ /dev/null @@ -1,322 +0,0 @@ -#!/usr/bin/env python3 -""" -ArXiv MCP Server implementation using Model Context Protocol. -Provides access to ArXiv research papers through search and retrieval tools. -""" - -import os -import sys -import json -from fastmcp import FastMCP -from dotenv import load_dotenv -import logging -from typing import Optional -import mcp_handlers - -# Configure logging -logging.basicConfig( - level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" -) -logger = logging.getLogger(__name__) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Load environment variables -load_dotenv() - -# Initialize MCP server -mcp: FastMCP = FastMCP("ArxivMCP") - - -@mcp.tool( - name="search_arxiv", - description="Search ArXiv for research papers by category or topic.", -) -async def search_arxiv_tool(query: str = "cs.AI", max_results: int = 5) -> dict: - """ - Search ArXiv for research papers by category or topic with comprehensive filtering and ranking capabilities. - - Args: - query (str, optional): Search query or category (default: "cs.AI") - max_results (int, optional): Maximum number of results to return (default: 5) - - Returns: - Dictionary with search results including paper metadata, abstracts, and ArXiv identifiers. - """ - logger.info(f"Searching ArXiv for query: {query}") - return await mcp_handlers.search_arxiv_handler(query, max_results) - - -@mcp.tool( - name="get_recent_papers", - description="Get recent papers from a specific ArXiv category.", -) -async def get_recent_papers_tool(category: str = "cs.AI", max_results: int = 5) -> dict: - """ - Get recent papers from a specific ArXiv category with chronological ordering and metadata extraction. - - Args: - category (str, optional): ArXiv category (default: "cs.AI") - max_results (int, optional): Maximum number of results to return (default: 5) - - Returns: - Dictionary with recent papers including publication dates, authors, and paper summaries. - """ - logger.info(f"Getting recent papers from category: {category}") - return await mcp_handlers.get_recent_papers_handler(category, max_results) - - -@mcp.tool( - name="search_papers_by_author", description="Search ArXiv papers by author name." -) -async def search_papers_by_author_tool(author: str, max_results: int = 10) -> dict: - """ - Search ArXiv papers by author name with comprehensive author matching and publication history. - - Args: - author (str): Author name to search for - max_results (int, optional): Maximum number of results to return (default: 10) - - Returns: - Dictionary with author's papers including co-authors, publication timeline, and research areas. - """ - logger.info(f"Searching papers by author: {author}") - return await mcp_handlers.search_papers_by_author_handler(author, max_results) - - -@mcp.tool(name="search_by_title", description="Search ArXiv papers by title keywords.") -async def search_by_title_tool(title_keywords: str, max_results: int = 10) -> dict: - """ - Search ArXiv papers by title keywords with intelligent keyword matching and relevance scoring. - - Args: - title_keywords (str): Keywords to search in paper titles - max_results (int, optional): Maximum number of results to return (default: 10) - - Returns: - Dictionary with search results ranked by title relevance and keyword matching. - """ - logger.info(f"Searching papers by title: {title_keywords}") - return await mcp_handlers.search_by_title_handler(title_keywords, max_results) - - -@mcp.tool( - name="search_by_abstract", description="Search ArXiv papers by abstract keywords." -) -async def search_by_abstract_tool( - abstract_keywords: str, max_results: int = 10 -) -> dict: - """ - Search ArXiv papers by abstract keywords with semantic content analysis and relevance ranking. - - Args: - abstract_keywords (str): Keywords to search in paper abstracts - max_results (int, optional): Maximum number of results to return (default: 10) - - Returns: - Dictionary with papers matching abstract content with relevance scores and keyword highlights. - """ - logger.info(f"Searching papers by abstract: {abstract_keywords}") - return await mcp_handlers.search_by_abstract_handler(abstract_keywords, max_results) - - -@mcp.tool( - name="search_by_subject", - description="Search ArXiv papers by subject classification.", -) -async def search_by_subject_tool(subject: str, max_results: int = 10) -> dict: - """ - Search ArXiv papers by subject classification with comprehensive category-based filtering. - - Args: - subject (str): ArXiv subject classification (e.g., 'cs.AI', 'physics.astro-ph') - max_results (int, optional): Maximum number of results to return (default: 10) - - Returns: - Dictionary with papers from specified subject areas with classification metadata. - """ - logger.info(f"Searching papers by subject: {subject}") - return await mcp_handlers.search_by_subject_handler(subject, max_results) - - -@mcp.tool( - name="search_date_range", - description="Search ArXiv papers within a specific date range.", -) -async def search_date_range_tool( - start_date: str, end_date: str, category: str = "", max_results: int = 20 -) -> dict: - """ - Search ArXiv papers within a specific date range with optional category filtering and chronological organization. - - Args: - start_date (str): Start date in YYYY-MM-DD format - end_date (str): End date in YYYY-MM-DD format - category (str, optional): Optional category filter (e.g., 'cs.AI') - max_results (int, optional): Maximum number of results to return (default: 20) - - Returns: - Dictionary with papers published within date range with temporal metadata and category information. - """ - logger.info(f"Searching papers by date range: {start_date} to {end_date}") - return await mcp_handlers.search_date_range_handler( - start_date, end_date, category, max_results - ) - - -@mcp.tool( - name="get_paper_details", - description="Get detailed information about a specific ArXiv paper by ID.", -) -async def get_paper_details_tool(arxiv_id: str) -> dict: - """ - Get detailed information about a specific ArXiv paper by ID with comprehensive metadata extraction. - - Args: - arxiv_id (str): ArXiv paper ID (e.g., '2301.12345' or 'cs/0501001') - - Returns: - Dictionary with detailed paper information including full abstract, authors, categories, and publication data. - """ - logger.info(f"Getting paper details for: {arxiv_id}") - return await mcp_handlers.get_paper_details_handler(arxiv_id) - - -@mcp.tool( - name="export_to_bibtex", - description="Export search results to BibTeX format for citation management.", -) -async def export_to_bibtex_tool(papers_json: str) -> dict: - """ - Export search results to BibTeX format for citation management and bibliography generation. - - Args: - papers_json (str): JSON string containing list of papers to export - - Returns: - Dictionary with BibTeX citations properly formatted for academic reference management. - """ - logger.info("Exporting papers to BibTeX format") - return await mcp_handlers.export_to_bibtex_handler(papers_json) - - -@mcp.tool( - name="find_similar_papers", - description="Find papers similar to a reference paper based on categories and keywords.", -) -async def find_similar_papers_tool( - reference_paper_id: str, max_results: int = 10 -) -> dict: - """ - Find papers similar to a reference paper based on categories, keywords, and content analysis. - - Args: - reference_paper_id (str): ArXiv ID of the reference paper - max_results (int, optional): Maximum number of similar papers to return (default: 10) - - Returns: - Dictionary with similar papers ranked by relevance with similarity scores and matching criteria. - """ - logger.info(f"Finding papers similar to: {reference_paper_id}") - return await mcp_handlers.find_similar_papers_handler( - reference_paper_id, max_results - ) - - -@mcp.tool( - name="download_paper_pdf", description="Download the PDF of a paper from ArXiv." -) -async def download_paper_pdf_tool( - arxiv_id: str, download_path: Optional[str] = None -) -> dict: - """ - Download the PDF of a paper from ArXiv with automatic file management and error handling. - - Args: - arxiv_id (str): ArXiv paper ID (e.g., '2301.12345' or 'cs/0501001') - download_path (str, optional): Optional path to save the PDF - - Returns: - Dictionary with download information. - """ - logger.info(f"Downloading PDF for paper: {arxiv_id}") - return await mcp_handlers.download_paper_pdf_handler(arxiv_id, download_path) - - -@mcp.tool( - name="get_pdf_url", - description="Get the direct PDF URL for a paper without downloading.", -) -async def get_pdf_url_tool(arxiv_id: str) -> dict: - """ - Get PDF URL for an ArXiv paper. - - Args: - arxiv_id: ArXiv paper ID (e.g., '2301.12345' or 'cs/0501001') - - Returns: - Dictionary with PDF URL information - """ - logger.info(f"Getting PDF URL for paper: {arxiv_id}") - return await mcp_handlers.get_pdf_url_handler(arxiv_id) - - -@mcp.tool( - name="download_multiple_pdfs", - description="Download multiple PDFs concurrently with rate limiting.", -) -async def download_multiple_pdfs_tool( - arxiv_ids_json: str, download_path: str | None = None, max_concurrent: int = 3 -) -> dict: - """ - Download multiple PDFs concurrently. - - Args: - arxiv_ids_json: JSON string containing list of ArXiv IDs - download_path: Optional path to save PDFs - max_concurrent: Maximum number of concurrent downloads - - Returns: - Dictionary with download results - """ - logger.info(f"Downloading multiple PDFs with max_concurrent: {max_concurrent}") - return await mcp_handlers.download_multiple_pdfs_handler( - arxiv_ids_json, download_path, max_concurrent - ) - - -def main(): - """ - Main entry point for the ArXiv MCP server. - Supports both stdio and SSE transports based on environment variables. - """ - try: - logger.info("Starting ArXiv MCP Server") - - # Determine which transport to use - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - if transport == "sse": - # SSE transport for web-based clients - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # Default stdio transport - logger.info("Starting stdio transport") - print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") - - except Exception as e: - logger.error(f"Server error: {e}") - print(json.dumps({"error": str(e)}), file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/arxiv/tests/test_advanced_scenarios.py b/clio-kit-mcp-servers/arxiv/tests/test_advanced_scenarios.py index cb0efb89..fe88bf13 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_advanced_scenarios.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_advanced_scenarios.py @@ -4,17 +4,12 @@ """ import pytest -import sys -import os import asyncio from unittest.mock import patch, Mock -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import mcp_handlers -from capabilities import text_search as search_tools -from capabilities import export_utils +from arxiv_mcp import mcp_handlers +from arxiv_mcp.capabilities import text_search as search_tools +from arxiv_mcp.capabilities import export_utils class TestAdvancedScenarios: @@ -420,7 +415,7 @@ def test_module_interaction_edge_cases(self): # Test search_tools integration with patch( - "capabilities.text_search.search_by_title", + "arxiv_mcp.capabilities.text_search.search_by_title", Mock(return_value={"papers": [], "count": 0}), ) as mock_search: if hasattr(search_tools, "search_by_title"): diff --git a/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base.py b/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base.py index e8a8ac1d..682c02bb 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base.py @@ -3,15 +3,10 @@ """ import pytest -import sys -import os import xml.etree.ElementTree as ET from unittest.mock import AsyncMock, MagicMock, patch -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.arxiv_base import ( +from arxiv_mcp.capabilities.arxiv_base import ( parse_arxiv_entry, execute_arxiv_query, generate_bibtex, diff --git a/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base_errors.py b/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base_errors.py index 53f4893b..41d2951a 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base_errors.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_arxiv_base_errors.py @@ -6,13 +6,8 @@ import httpx from unittest.mock import patch, Mock, AsyncMock import xml.etree.ElementTree as ET -import sys -import os -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.arxiv_base import ( +from arxiv_mcp.capabilities.arxiv_base import ( execute_arxiv_query, generate_bibtex, parse_arxiv_entry, @@ -23,7 +18,7 @@ class TestArxivBaseErrors: """Test error handling in arxiv_base module.""" @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_timeout_exception(self, mock_client): """Test TimeoutException handling.""" mock_response = Mock() @@ -39,7 +34,7 @@ async def test_timeout_exception(self, mock_client): assert "ArXiv API request timed out" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_http_status_error(self, mock_client): """Test HTTPStatusError handling.""" # Create mock response that raises HTTPStatusError @@ -65,7 +60,7 @@ async def test_http_status_error(self, mock_client): assert "ArXiv API error: 503" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_parse_error(self, mock_client): """Test XML ParseError handling.""" mock_response = Mock() @@ -80,7 +75,7 @@ async def test_parse_error(self, mock_client): # Mock ET.fromstring to raise ParseError with patch( - "capabilities.arxiv_base.ET.fromstring", + "arxiv_mcp.capabilities.arxiv_base.ET.fromstring", side_effect=ET.ParseError("Invalid XML"), ): with pytest.raises(Exception) as exc_info: @@ -91,7 +86,7 @@ async def test_parse_error(self, mock_client): assert "Failed to parse ArXiv response" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_unexpected_error(self, mock_client): """Test unexpected error handling.""" mock_client_instance = Mock() @@ -295,7 +290,7 @@ def test_parse_arxiv_entry_malformed_xml(self): assert result["summary"] == "" @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_network_connectivity_errors(self, mock_client): """Test various network connectivity errors.""" @@ -312,7 +307,7 @@ async def test_network_connectivity_errors(self, mock_client): ) or "ArXiv query failed" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_malformed_response_handling(self, mock_client): """Test handling of malformed API responses.""" @@ -331,7 +326,7 @@ async def test_malformed_response_handling(self, mock_client): assert "ArXiv query failed" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_partial_xml_response(self, mock_client): """Test handling of partial/truncated XML responses.""" @@ -358,7 +353,7 @@ async def test_partial_xml_response(self, mock_client): assert "ArXiv query failed" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_empty_response_handling(self, mock_client): """Test handling of empty API responses.""" @@ -377,7 +372,7 @@ async def test_empty_response_handling(self, mock_client): assert "ArXiv query failed" in str(exc_info.value) @pytest.mark.asyncio - @patch("capabilities.arxiv_base.httpx.AsyncClient") + @patch("arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient") async def test_api_parameter_validation(self, mock_client): """Test API parameter validation and edge cases.""" @@ -462,7 +457,9 @@ def test_id_extraction_edge_cases(self): async def test_query_parameter_encoding(self): """Test that query parameters are properly encoded.""" - with patch("capabilities.arxiv_base.httpx.AsyncClient") as mock_client: + with patch( + "arxiv_mcp.capabilities.arxiv_base.httpx.AsyncClient" + ) as mock_client: mock_response = AsyncMock() mock_response.content = b'' mock_response.raise_for_status = Mock() diff --git a/clio-kit-mcp-servers/arxiv/tests/test_category_search.py b/clio-kit-mcp-servers/arxiv/tests/test_category_search.py index db08939b..cfcb0a12 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_category_search.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_category_search.py @@ -3,13 +3,8 @@ """ import pytest -import sys -import os -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.category_search import ( +from arxiv_mcp.capabilities.category_search import ( search_arxiv, get_recent_papers, search_by_subject, diff --git a/clio-kit-mcp-servers/arxiv/tests/test_date_search.py b/clio-kit-mcp-servers/arxiv/tests/test_date_search.py index e2e178c7..c2f59ce4 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_date_search.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_date_search.py @@ -3,14 +3,9 @@ """ import pytest -import sys -import os from unittest.mock import AsyncMock, patch -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.date_search import search_date_range +from arxiv_mcp.capabilities.date_search import search_date_range class TestDateSearch: @@ -35,7 +30,8 @@ async def test_search_date_range_success(self): ] with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = mock_papers @@ -74,7 +70,8 @@ async def test_search_date_range_with_category(self): ] with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = mock_papers @@ -101,7 +98,8 @@ async def test_search_date_range_with_category(self): async def test_search_date_range_no_results(self): """Test date range search with no results""" with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = [] @@ -118,7 +116,8 @@ async def test_search_date_range_custom_max_results(self): mock_papers = [{"id": f"paper_{i}"} for i in range(50)] with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = mock_papers @@ -147,7 +146,8 @@ async def test_search_date_range_date_formatting(self): ] with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = [] @@ -162,7 +162,8 @@ async def test_search_date_range_date_formatting(self): async def test_search_date_range_with_empty_category(self): """Test date range search with empty category string""" with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = [] @@ -179,7 +180,8 @@ async def test_search_date_range_with_empty_category(self): async def test_search_date_range_exception_handling(self): """Test that exceptions from execute_arxiv_query are propagated""" with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.side_effect = Exception("API Error") @@ -190,7 +192,8 @@ async def test_search_date_range_exception_handling(self): async def test_search_date_range_complex_category(self): """Test date range search with complex category string""" with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = [] @@ -210,7 +213,8 @@ async def test_search_date_range_parameter_consistency(self): mock_papers = [{"id": "test_paper"}] with patch( - "capabilities.date_search.execute_arxiv_query", new_callable=AsyncMock + "arxiv_mcp.capabilities.date_search.execute_arxiv_query", + new_callable=AsyncMock, ) as mock_query: mock_query.return_value = mock_papers diff --git a/clio-kit-mcp-servers/arxiv/tests/test_download_paper.py b/clio-kit-mcp-servers/arxiv/tests/test_download_paper.py index 20550eb9..56782982 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_download_paper.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_download_paper.py @@ -7,12 +7,8 @@ import shutil import pytest from unittest.mock import patch, MagicMock -import sys -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.download_paper import ( +from arxiv_mcp.capabilities.download_paper import ( download_paper_pdf, get_pdf_url, download_multiple_pdfs, @@ -142,7 +138,9 @@ async def test_download_multiple_pdfs_success(self): """Test successful multiple PDF downloads.""" arxiv_ids = ["1706.03762", "2301.12345"] - with patch("capabilities.download_paper.download_paper_pdf") as mock_download: + with patch( + "arxiv_mcp.capabilities.download_paper.download_paper_pdf" + ) as mock_download: # Mock successful downloads mock_download.side_effect = [ { @@ -172,7 +170,9 @@ async def test_download_multiple_pdfs_partial_failure(self): """Test multiple PDF downloads with partial failures.""" arxiv_ids = ["1706.03762", "invalid_id"] - with patch("capabilities.download_paper.download_paper_pdf") as mock_download: + with patch( + "arxiv_mcp.capabilities.download_paper.download_paper_pdf" + ) as mock_download: # Mock one success and one failure mock_download.side_effect = [ { diff --git a/clio-kit-mcp-servers/arxiv/tests/test_edge_cases.py b/clio-kit-mcp-servers/arxiv/tests/test_edge_cases.py index 3fe4a690..f70e8206 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_edge_cases.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_edge_cases.py @@ -4,22 +4,17 @@ """ import pytest -import sys -import os from unittest.mock import patch, AsyncMock, Mock -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import mcp_handlers -from capabilities.date_search import search_date_range -from capabilities.export_utils import format_paper_summary, export_to_bibtex -from capabilities.download_paper import ( +from arxiv_mcp import mcp_handlers +from arxiv_mcp.capabilities.date_search import search_date_range +from arxiv_mcp.capabilities.export_utils import format_paper_summary, export_to_bibtex +from arxiv_mcp.capabilities.download_paper import ( download_paper_pdf, get_pdf_url, download_multiple_pdfs, ) -from capabilities.paper_details import get_paper_details, find_similar_papers +from arxiv_mcp.capabilities.paper_details import get_paper_details, find_similar_papers class TestEdgeCases: @@ -30,7 +25,9 @@ async def test_download_paper_error_handling(self): """Test all error handling paths in download_paper.py.""" # Test different exception scenarios to hit error lines 32, 39, 84, 86-87, 107, 137, 165 - with patch("capabilities.download_paper.httpx.AsyncClient") as mock_client: + with patch( + "arxiv_mcp.capabilities.download_paper.httpx.AsyncClient" + ) as mock_client: # Scenario 1: Connection error in download_paper_pdf mock_context = AsyncMock() mock_client.return_value.__aenter__.return_value = mock_context @@ -97,7 +94,9 @@ async def test_download_paper_error_handling(self): async def test_paper_details_error_handling(self): """Test paper_details.py error handling lines 42, 54, 61, 99.""" - with patch("capabilities.paper_details.execute_arxiv_query") as mock_query: + with patch( + "arxiv_mcp.capabilities.paper_details.execute_arxiv_query" + ) as mock_query: # Test different exception types to hit all error handling branches (reduced for speed) error_scenarios = [ Exception("Base exception"), @@ -167,7 +166,7 @@ def test_export_utils_edge_cases(self): async def test_export_bibtex_error_handling(self): """Test export_to_bibtex error handling.""" - with patch("capabilities.export_utils.generate_bibtex") as mock_gen: + with patch("arxiv_mcp.capabilities.export_utils.generate_bibtex") as mock_gen: # Test with different error scenarios error_scenarios = [ Exception("BibTeX generation failed"), @@ -221,7 +220,9 @@ async def test_mcp_handlers_json_parsing_errors(self): async def test_date_search_edge_cases(self): """Test date_search.py edge cases and line 34 coverage.""" - with patch("capabilities.date_search.execute_arxiv_query") as mock_query: + with patch( + "arxiv_mcp.capabilities.date_search.execute_arxiv_query" + ) as mock_query: mock_query.return_value = {"papers": [], "count": 0} # Test edge cases for date range search @@ -266,7 +267,9 @@ async def test_comprehensive_error_scenarios(self): for error_class, error_message in error_types: # Test download_paper module - with patch("capabilities.download_paper.httpx.AsyncClient") as mock_client: + with patch( + "arxiv_mcp.capabilities.download_paper.httpx.AsyncClient" + ) as mock_client: mock_client.side_effect = error_class(error_message) try: @@ -280,7 +283,9 @@ async def test_comprehensive_error_scenarios(self): pass # Test paper_details module - with patch("capabilities.paper_details.execute_arxiv_query") as mock_query: + with patch( + "arxiv_mcp.capabilities.paper_details.execute_arxiv_query" + ) as mock_query: mock_query.side_effect = error_class(error_message) try: diff --git a/clio-kit-mcp-servers/arxiv/tests/test_export_utils.py b/clio-kit-mcp-servers/arxiv/tests/test_export_utils.py index 90c8226d..33fbffcc 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_export_utils.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_export_utils.py @@ -3,18 +3,13 @@ """ import pytest -import sys -import os -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.export_utils import ( +from arxiv_mcp.capabilities.export_utils import ( export_to_bibtex, format_paper_summary, format_search_results, ) -from capabilities.arxiv_base import generate_bibtex +from arxiv_mcp.capabilities.arxiv_base import generate_bibtex class TestExportUtils: diff --git a/clio-kit-mcp-servers/arxiv/tests/test_fastmcp_tools.py b/clio-kit-mcp-servers/arxiv/tests/test_fastmcp_tools.py index 2e3f69db..8e24a0b0 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_fastmcp_tools.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_fastmcp_tools.py @@ -11,10 +11,9 @@ import tempfile from unittest.mock import patch, AsyncMock -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError -import server +from arxiv_mcp import server class TestFastMCPTools: @@ -25,7 +24,7 @@ async def test_all_tool_functions_execution(self): """Execute all FastMCP tool functions to hit logger statements.""" with ( - patch("server.logger"), + patch("arxiv_mcp.server.logger"), patch.object(server, "mcp_handlers") as mock_handlers, ): # Configure all handlers to return proper responses @@ -67,7 +66,7 @@ async def test_all_tool_functions_execution(self): return_value={"status": "success"} ) - # Try to call the actual decorated functions to hit logger statements + # In FastMCP 3.0, decorated functions are the original functions tool_functions = [ ("search_arxiv_tool", ["cs.AI", 5]), ("get_recent_papers_tool", ["cs.AI", 5]), @@ -75,13 +74,13 @@ async def test_all_tool_functions_execution(self): ("search_by_title_tool", ["Test Title", 5]), ("search_by_abstract_tool", ["Test Abstract", 5]), ("search_by_subject_tool", ["Test Subject", 5]), - ("search_date_range_tool", ["2023-01-01", "2023-12-31", 5]), + ("search_date_range_tool", ["2023-01-01", "2023-12-31"]), ("get_paper_details_tool", ["test-id"]), ("find_similar_papers_tool", ["test-id", 5]), - ("export_to_bibtex_tool", [["test-id"]]), + ("export_to_bibtex_tool", ['["test-id"]']), ("download_paper_pdf_tool", ["test-id", "/tmp"]), ("get_pdf_url_tool", ["test-id"]), - ("download_multiple_pdfs_tool", [["test-id"], "/tmp"]), + ("download_multiple_pdfs_tool", ['["test-id"]', "/tmp"]), ] executed_count = 0 @@ -106,7 +105,7 @@ async def test_all_tool_functions_execution(self): async def test_fastmcp_tools_direct_access(self): """Try to access FastMCP tools directly through the mcp instance.""" - with patch("server.logger"): + with patch("arxiv_mcp.server.logger"): # Try to access FastMCP tools through various methods if hasattr(server, "mcp"): mcp_instance = server.mcp @@ -135,11 +134,11 @@ async def test_fastmcp_tools_direct_access(self): if "search" in tool_name.lower(): await handler("test", 5) elif "date" in tool_name.lower(): - await handler("2023-01-01", "2023-12-31", 5) + await handler("2023-01-01", "2023-12-31") elif "download" in tool_name.lower(): await handler("test", "/tmp") elif "bibtex" in tool_name.lower(): - await handler(["test"]) + await handler('["test"]') else: await handler("test") except Exception: @@ -195,8 +194,8 @@ async def test_tool_functions_with_varied_parameters(self): ("search_by_title_tool", ["Machine Learning", 10]), ("search_by_abstract_tool", ["neural networks", 8]), ("search_by_subject_tool", ["computer science", 12]), - ("search_date_range_tool", ["2022-01-01", "2022-12-31", 10]), - ("search_date_range_tool", ["2021-06-01", "2021-06-30", 5]), + ("search_date_range_tool", ["2022-01-01", "2022-12-31"]), + ("search_date_range_tool", ["2021-06-01", "2021-06-30"]), ] for func_name, args in test_scenarios: @@ -213,7 +212,7 @@ async def test_tool_functions_with_varied_parameters(self): @pytest.mark.asyncio async def test_server_tool_error_scenarios(self): - """Test tool functions with error scenarios.""" + """Test tool functions with error scenarios raise ToolError.""" with patch.object(server, "mcp_handlers") as mock_handlers: # Configure handlers to raise exceptions @@ -227,30 +226,23 @@ async def test_server_tool_error_scenarios(self): side_effect=ConnectionError("Network error") ) - # Test that tool functions handle handler errors gracefully - error_test_cases = [ - ("search_arxiv_tool", ["cs.AI", 5]), - ("get_recent_papers_tool", ["cs.AI", 5]), - ("search_papers_by_author_tool", ["Test Author", 5]), - ] + # Test that tool functions raise ToolError + with pytest.raises(ToolError, match="Handler error"): + await server.search_arxiv_tool("cs.AI", 5) - for func_name, args in error_test_cases: - if hasattr(server, func_name): - func = getattr(server, func_name) - try: - if asyncio.iscoroutinefunction(func): - await func(*args) - else: - func(*args) - except Exception: - # Expected to fail, but should hit error handling code - pass + with pytest.raises(ToolError, match="Invalid parameters"): + await server.get_recent_papers_tool("cs.AI", 5) + + with pytest.raises(ToolError, match="Network error"): + await server.search_papers_by_author_tool("Test Author", 5) def test_server_main_execution_simulation(self): """Test server.py main execution block simulation.""" # Read server.py content to verify main execution block exists - server_file = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") + server_file = os.path.join( + os.path.dirname(__file__), "..", "src", "arxiv_mcp", "server.py" + ) with open(server_file, "r") as f: content = f.read() @@ -259,7 +251,7 @@ def test_server_main_execution_simulation(self): assert "main()" in content # Try to simulate the execution without actually running the server - with patch("server.main"): + with patch("arxiv_mcp.server.main"): # Import server and manually trigger the condition import importlib @@ -286,7 +278,7 @@ def mock_main(): with patch('server.main', mock_main): # Import server (this loads the module) import server - + # Manually trigger the main execution logic if __name__ == "__main__": server.main() # This should hit line 322 @@ -320,7 +312,7 @@ async def test_tool_function_comprehensive_coverage(self): """Comprehensive test to hit as many tool function lines as possible.""" with ( - patch("server.logger"), + patch("arxiv_mcp.server.logger"), patch.object(server, "mcp_handlers") as mock_handlers, ): # Configure all handlers with varied responses @@ -382,25 +374,25 @@ async def test_tool_function_comprehensive_coverage(self): ("search_by_subject_tool", ["computer science", 5]), ("search_by_subject_tool", ["mathematics", 6]), # Date range searches - ("search_date_range_tool", ["2023-01-01", "2023-12-31", 5]), - ("search_date_range_tool", ["2022-06-01", "2022-06-30", 3]), + ("search_date_range_tool", ["2023-01-01", "2023-12-31"]), + ("search_date_range_tool", ["2022-06-01", "2022-06-30"]), # Paper details ("get_paper_details_tool", ["2301.12345"]), ("get_paper_details_tool", ["1234.5678"]), ("find_similar_papers_tool", ["2301.12345", 5]), ("find_similar_papers_tool", ["1234.5678", 3]), # Export functions - ("export_to_bibtex_tool", [["2301.12345"]]), - ("export_to_bibtex_tool", [["1234.5678", "2301.12345"]]), + ("export_to_bibtex_tool", ['["2301.12345"]']), + ("export_to_bibtex_tool", ['["1234.5678", "2301.12345"]']), # Download functions ("download_paper_pdf_tool", ["2301.12345", "/tmp"]), ("download_paper_pdf_tool", ["1234.5678", "/tmp/downloads"]), ("get_pdf_url_tool", ["2301.12345"]), ("get_pdf_url_tool", ["1234.5678"]), - ("download_multiple_pdfs_tool", [["2301.12345"], "/tmp"]), + ("download_multiple_pdfs_tool", ['["2301.12345"]', "/tmp"]), ( "download_multiple_pdfs_tool", - [["1234.5678", "2301.12345"], "/tmp/batch"], + ['["1234.5678", "2301.12345"]', "/tmp/batch"], ), ] diff --git a/clio-kit-mcp-servers/arxiv/tests/test_integration.py b/clio-kit-mcp-servers/arxiv/tests/test_integration.py index 42bea8f4..d8d36c9e 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_integration.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_integration.py @@ -3,14 +3,9 @@ """ import pytest -import sys -import os import json -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import mcp_handlers +from arxiv_mcp import mcp_handlers class TestIntegration: diff --git a/clio-kit-mcp-servers/arxiv/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/arxiv/tests/test_mcp_handlers.py index fdb3d84b..d8265fe2 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_mcp_handlers.py @@ -6,13 +6,8 @@ import pytest import asyncio from unittest.mock import patch, AsyncMock, Mock -import sys -import os -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import mcp_handlers +from arxiv_mcp import mcp_handlers class TestMCPHandlers: @@ -23,7 +18,9 @@ async def test_search_arxiv_handler_success(self): """Test search_arxiv_handler with successful response.""" expected_result = {"papers": [{"id": "test"}]} - with patch("mcp_handlers.search_arxiv", new_callable=AsyncMock) as mock_search: + with patch( + "arxiv_mcp.mcp_handlers.search_arxiv", new_callable=AsyncMock + ) as mock_search: mock_search.return_value = expected_result result = await mcp_handlers.search_arxiv_handler("cs.AI", 5) @@ -34,7 +31,9 @@ async def test_search_arxiv_handler_success(self): @pytest.mark.asyncio async def test_search_arxiv_handler_error(self): """Test search_arxiv_handler with error handling.""" - with patch("mcp_handlers.search_arxiv", new_callable=AsyncMock) as mock_search: + with patch( + "arxiv_mcp.mcp_handlers.search_arxiv", new_callable=AsyncMock + ) as mock_search: mock_search.side_effect = ValueError("Test error") result = await mcp_handlers.search_arxiv_handler("cs.AI", 5) @@ -50,7 +49,7 @@ async def test_get_recent_papers_handler_success(self): expected_result = {"papers": [{"id": "recent"}]} with patch( - "mcp_handlers.get_recent_papers", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.get_recent_papers", new_callable=AsyncMock ) as mock_recent: mock_recent.return_value = expected_result @@ -63,7 +62,7 @@ async def test_get_recent_papers_handler_success(self): async def test_get_recent_papers_handler_error(self): """Test get_recent_papers_handler with error handling.""" with patch( - "mcp_handlers.get_recent_papers", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.get_recent_papers", new_callable=AsyncMock ) as mock_recent: mock_recent.side_effect = ConnectionError("Network error") @@ -80,7 +79,7 @@ async def test_search_papers_by_author_handler_success(self): expected_result = {"papers": [{"author": "Test Author"}]} with patch( - "mcp_handlers.search_papers_by_author", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_papers_by_author", new_callable=AsyncMock ) as mock_author: mock_author.return_value = expected_result @@ -95,7 +94,7 @@ async def test_search_papers_by_author_handler_success(self): async def test_search_papers_by_author_handler_error(self): """Test search_papers_by_author_handler with error handling.""" with patch( - "mcp_handlers.search_papers_by_author", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_papers_by_author", new_callable=AsyncMock ) as mock_author: mock_author.side_effect = RuntimeError("Runtime error") @@ -114,7 +113,7 @@ async def test_search_by_title_handler_success(self): expected_result = {"papers": [{"title": "Test Title"}]} with patch( - "mcp_handlers.search_by_title", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_title", new_callable=AsyncMock ) as mock_title: mock_title.return_value = expected_result @@ -127,7 +126,7 @@ async def test_search_by_title_handler_success(self): async def test_search_by_title_handler_error(self): """Test search_by_title_handler with error handling.""" with patch( - "mcp_handlers.search_by_title", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_title", new_callable=AsyncMock ) as mock_title: mock_title.side_effect = Exception("Generic error") @@ -144,7 +143,7 @@ async def test_search_by_abstract_handler_success(self): expected_result = {"papers": [{"abstract": "machine learning"}]} with patch( - "mcp_handlers.search_by_abstract", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_abstract", new_callable=AsyncMock ) as mock_abstract: mock_abstract.return_value = expected_result @@ -159,7 +158,7 @@ async def test_search_by_abstract_handler_success(self): async def test_search_by_abstract_handler_error(self): """Test search_by_abstract_handler with error handling.""" with patch( - "mcp_handlers.search_by_abstract", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_abstract", new_callable=AsyncMock ) as mock_abstract: mock_abstract.side_effect = KeyError("Key not found") @@ -178,7 +177,7 @@ async def test_search_by_subject_handler_success(self): expected_result = {"papers": [{"subject": "Computer Science"}]} with patch( - "mcp_handlers.search_by_subject", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_subject", new_callable=AsyncMock ) as mock_subject: mock_subject.return_value = expected_result @@ -193,7 +192,7 @@ async def test_search_by_subject_handler_success(self): async def test_search_by_subject_handler_error(self): """Test search_by_subject_handler with error handling.""" with patch( - "mcp_handlers.search_by_subject", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_by_subject", new_callable=AsyncMock ) as mock_subject: mock_subject.side_effect = AttributeError("Attribute error") @@ -212,7 +211,7 @@ async def test_search_date_range_handler_success(self): expected_result = {"papers": [{"date": "2023-06-15"}]} with patch( - "mcp_handlers.search_date_range", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_date_range", new_callable=AsyncMock ) as mock_date: mock_date.return_value = expected_result @@ -227,7 +226,7 @@ async def test_search_date_range_handler_success(self): async def test_search_date_range_handler_error(self): """Test search_date_range_handler with error handling.""" with patch( - "mcp_handlers.search_date_range", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_date_range", new_callable=AsyncMock ) as mock_date: mock_date.side_effect = TypeError("Type error") @@ -246,7 +245,7 @@ async def test_get_paper_details_handler_success(self): expected_result = {"paper": {"id": "2023.12345", "details": True}} with patch( - "mcp_handlers.get_paper_details", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.get_paper_details", new_callable=AsyncMock ) as mock_details: mock_details.return_value = expected_result @@ -259,7 +258,7 @@ async def test_get_paper_details_handler_success(self): async def test_get_paper_details_handler_error(self): """Test get_paper_details_handler with error handling.""" with patch( - "mcp_handlers.get_paper_details", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.get_paper_details", new_callable=AsyncMock ) as mock_details: mock_details.side_effect = FileNotFoundError("Paper not found") @@ -276,7 +275,7 @@ async def test_find_similar_papers_handler_success(self): expected_result = {"similar_papers": [{"id": "2023.67890"}]} with patch( - "mcp_handlers.find_similar_papers", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.find_similar_papers", new_callable=AsyncMock ) as mock_similar: mock_similar.return_value = expected_result @@ -289,7 +288,7 @@ async def test_find_similar_papers_handler_success(self): async def test_find_similar_papers_handler_error(self): """Test find_similar_papers_handler with error handling.""" with patch( - "mcp_handlers.find_similar_papers", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.find_similar_papers", new_callable=AsyncMock ) as mock_similar: mock_similar.side_effect = IndexError("Index error") @@ -306,7 +305,7 @@ async def test_export_to_bibtex_handler_success(self): expected_result = {"bibtex": "@article{test,title={Test}}"} with patch( - "mcp_handlers.export_to_bibtex", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.export_to_bibtex", new_callable=AsyncMock ) as mock_export: mock_export.return_value = expected_result @@ -320,7 +319,7 @@ async def test_export_to_bibtex_handler_success(self): async def test_export_to_bibtex_handler_error(self): """Test export_to_bibtex_handler with error handling.""" with patch( - "mcp_handlers.export_to_bibtex", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.export_to_bibtex", new_callable=AsyncMock ) as mock_export: mock_export.side_effect = PermissionError("Permission denied") @@ -337,7 +336,7 @@ async def test_download_paper_pdf_handler_success(self): expected_result = {"status": "success", "file_path": "/tmp/paper.pdf"} with patch( - "mcp_handlers.download_paper_pdf", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.download_paper_pdf", new_callable=AsyncMock ) as mock_download: mock_download.return_value = expected_result @@ -350,7 +349,7 @@ async def test_download_paper_pdf_handler_success(self): async def test_download_paper_pdf_handler_error(self): """Test download_paper_pdf_handler with error handling.""" with patch( - "mcp_handlers.download_paper_pdf", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.download_paper_pdf", new_callable=AsyncMock ) as mock_download: mock_download.side_effect = OSError("OS error") @@ -366,7 +365,9 @@ async def test_get_pdf_url_handler_success(self): """Test get_pdf_url_handler with successful response.""" expected_result = {"pdf_url": "https://arxiv.org/pdf/2023.12345.pdf"} - with patch("mcp_handlers.get_pdf_url", new_callable=AsyncMock) as mock_url: + with patch( + "arxiv_mcp.mcp_handlers.get_pdf_url", new_callable=AsyncMock + ) as mock_url: mock_url.return_value = expected_result result = await mcp_handlers.get_pdf_url_handler("2023.12345") @@ -377,7 +378,9 @@ async def test_get_pdf_url_handler_success(self): @pytest.mark.asyncio async def test_get_pdf_url_handler_error(self): """Test get_pdf_url_handler with error handling.""" - with patch("mcp_handlers.get_pdf_url", new_callable=AsyncMock) as mock_url: + with patch( + "arxiv_mcp.mcp_handlers.get_pdf_url", new_callable=AsyncMock + ) as mock_url: mock_url.side_effect = ImportError("Import error") result = await mcp_handlers.get_pdf_url_handler("2023.12345") @@ -393,7 +396,7 @@ async def test_download_multiple_pdfs_handler_success(self): expected_result = {"status": "success", "downloaded": 2} with patch( - "mcp_handlers.download_multiple_pdfs", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.download_multiple_pdfs", new_callable=AsyncMock ) as mock_multi: mock_multi.return_value = expected_result @@ -409,7 +412,7 @@ async def test_download_multiple_pdfs_handler_success(self): async def test_download_multiple_pdfs_handler_error(self): """Test download_multiple_pdfs_handler with error handling.""" with patch( - "mcp_handlers.download_multiple_pdfs", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.download_multiple_pdfs", new_callable=AsyncMock ) as mock_multi: mock_multi.side_effect = NotImplementedError("Not implemented") @@ -449,7 +452,7 @@ async def test_all_handlers_error_format_consistency(self): # Mock the underlying function to raise an exception func_name = handler_name.replace("_handler", "") with patch( - f"mcp_handlers.{func_name}", new_callable=AsyncMock + f"arxiv_mcp.mcp_handlers.{func_name}", new_callable=AsyncMock ) as mock_func: mock_func.side_effect = RuntimeError("Test error") @@ -755,7 +758,7 @@ async def test_exception_type_coverage(self): for exception_type, message in exception_types: # Test with search_arxiv_handler as representative with patch( - "mcp_handlers.search_arxiv", new_callable=AsyncMock + "arxiv_mcp.mcp_handlers.search_arxiv", new_callable=AsyncMock ) as mock_search: mock_search.side_effect = exception_type(message) @@ -792,7 +795,7 @@ async def test_handler_metadata_consistency(self): # Force an error to check metadata func_name = handler_name.replace("_handler", "") with patch( - f"mcp_handlers.{func_name}", new_callable=AsyncMock + f"arxiv_mcp.mcp_handlers.{func_name}", new_callable=AsyncMock ) as mock_func: mock_func.side_effect = ValueError("Test error") diff --git a/clio-kit-mcp-servers/arxiv/tests/test_paper_details.py b/clio-kit-mcp-servers/arxiv/tests/test_paper_details.py index 614d3b29..85643e05 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_paper_details.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_paper_details.py @@ -3,13 +3,8 @@ """ import pytest -import sys -import os -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.paper_details import get_paper_details, find_similar_papers +from arxiv_mcp.capabilities.paper_details import get_paper_details, find_similar_papers class TestPaperDetails: diff --git a/clio-kit-mcp-servers/arxiv/tests/test_server.py b/clio-kit-mcp-servers/arxiv/tests/test_server.py index 41609f6f..11dd1b90 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_server.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_server.py @@ -7,12 +7,10 @@ import asyncio import os from unittest.mock import patch, AsyncMock, MagicMock -import sys -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError -import server +from arxiv_mcp import server class TestArxivMCPServer: @@ -29,62 +27,66 @@ def test_main_function_exists(self): assert hasattr(server, "main") assert callable(server.main) - @patch("server.mcp") + @patch("arxiv_mcp.server.mcp") def test_main_function_runs_stdio(self, mock_mcp): """Test that main function runs the MCP server with stdio.""" mock_mcp.run = MagicMock() - with patch.dict(os.environ, {}, clear=True): + with patch("sys.argv", ["arxiv-mcp"]): server.main() # Verify mcp.run was called with stdio mock_mcp.run.assert_called_once_with(transport="stdio") - @patch("server.mcp") - def test_main_function_runs_sse(self, mock_mcp): - """Test that main function runs the MCP server with SSE.""" + @patch("arxiv_mcp.server.mcp") + def test_main_function_runs_http(self, mock_mcp): + """Test that main function runs the MCP server with HTTP transport.""" mock_mcp.run = MagicMock() - with patch.dict( - os.environ, - { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "localhost", - "MCP_SSE_PORT": "8080", - }, + with patch( + "sys.argv", + [ + "arxiv-mcp", + "--transport", + "http", + "--host", + "localhost", + "--port", + "8080", + ], ): server.main() - # Verify mcp.run was called with SSE parameters + # Verify mcp.run was called with HTTP parameters mock_mcp.run.assert_called_once_with( - transport="sse", host="localhost", port=8080 + transport="http", host="localhost", port=8080 ) - @patch("server.mcp") + @patch("arxiv_mcp.server.mcp") def test_main_function_error_handling(self, mock_mcp): - """Test that main function handles errors properly.""" + """Test that main function propagates errors from mcp.run.""" mock_mcp.run = MagicMock(side_effect=Exception("Test error")) - with pytest.raises(SystemExit): - server.main() + with patch("sys.argv", ["arxiv-mcp"]): + with pytest.raises(Exception, match="Test error"): + server.main() def test_logger_configuration(self): """Test that logger is properly configured.""" assert hasattr(server, "logger") - assert server.logger.name == "server" + assert server.logger.name == "arxiv_mcp.server" def test_mcp_instance_exists(self): """Test that MCP instance is created.""" assert hasattr(server, "mcp") assert server.mcp is not None - def test_sys_path_modification(self): - """Test that current directory is added to sys.path.""" - # The module should add its directory to sys.path - current_dir = os.path.dirname(server.__file__) - assert current_dir in sys.path + def test_module_file_exists(self): + """Test that the server module file exists.""" + assert server.__file__ is not None + assert os.path.exists(server.__file__) - @patch("server.load_dotenv") + @patch("arxiv_mcp.server.load_dotenv") def test_environment_loading(self, mock_load_dotenv): """Test that environment variables are loaded.""" # load_dotenv is called when the module is imported @@ -100,60 +102,66 @@ def test_mcp_tools_are_registered(self): # This is a basic check that the decorators worked assert mcp_instance is not None # FastMCP stores tools differently, let's just verify the instance is created properly - assert mcp_instance.name == "ArxivMCP" + assert mcp_instance.name == "arxiv" def test_imports_successful(self): """Test that all required imports are successful.""" # Test that all required modules are imported assert hasattr(server, "os") - assert hasattr(server, "sys") - assert hasattr(server, "json") assert hasattr(server, "FastMCP") assert hasattr(server, "load_dotenv") assert hasattr(server, "logging") assert hasattr(server, "mcp_handlers") - @patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}) def test_transport_selection_stdio(self): """Test that stdio transport is selected correctly.""" - with patch("server.mcp") as mock_mcp: + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run = MagicMock() - server.main() + with patch("sys.argv", ["arxiv-mcp", "--transport", "stdio"]): + server.main() mock_mcp.run.assert_called_with(transport="stdio") - @patch.dict( - os.environ, - {"MCP_TRANSPORT": "SSE", "MCP_SSE_HOST": "test.host", "MCP_SSE_PORT": "9999"}, - ) - def test_transport_selection_sse(self): - """Test that SSE transport is selected correctly.""" - with patch("server.mcp") as mock_mcp: + def test_transport_selection_http(self): + """Test that HTTP transport is selected correctly.""" + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run = MagicMock() - server.main() + with patch( + "sys.argv", + [ + "arxiv-mcp", + "--transport", + "http", + "--host", + "test.host", + "--port", + "9999", + ], + ): + server.main() mock_mcp.run.assert_called_with( - transport="sse", host="test.host", port=9999 + transport="http", host="test.host", port=9999 ) def test_default_environment_values(self): """Test default values when environment variables are not set.""" with patch.dict(os.environ, {}, clear=True): - with patch("server.mcp") as mock_mcp: + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run = MagicMock() - server.main() + with patch("sys.argv", ["arxiv-mcp"]): + server.main() # Should default to stdio mock_mcp.run.assert_called_with(transport="stdio") - @patch("server.mcp") - @patch("server.logger") - def test_logging_messages(self, mock_logger, mock_mcp): - """Test that appropriate log messages are generated.""" + @patch("arxiv_mcp.server.mcp") + def test_main_runs_without_error(self, mock_mcp): + """Test that main function runs without error.""" mock_mcp.run = MagicMock() - with patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}): + with patch("sys.argv", ["arxiv-mcp"]): server.main() - # Check that info logging was called - mock_logger.info.assert_called() + # Check that mcp.run was called + mock_mcp.run.assert_called_once() def test_main_entry_point(self): """Test the main entry point functionality.""" @@ -168,7 +176,7 @@ def test_module_constants(self): assert hasattr(server, "logger") # Check that the MCP server name is set correctly - assert server.mcp.name == "ArxivMCP" or "arxiv" in server.mcp.name.lower() + assert server.mcp.name == "arxiv" or "arxiv" in server.mcp.name.lower() def test_handler_integration(self): """Test that mcp_handlers module is properly imported and accessible.""" @@ -176,280 +184,242 @@ def test_handler_integration(self): assert hasattr(server.mcp_handlers, "search_arxiv_handler") assert callable(server.mcp_handlers.search_arxiv_handler) - @patch("server.print") - def test_error_output_format(self, mock_print): - """Test that error outputs are properly formatted as JSON.""" - with patch("server.mcp") as mock_mcp: + def test_error_propagation(self): + """Test that errors from mcp.run propagate.""" + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run = MagicMock(side_effect=ValueError("Test error")) - with pytest.raises(SystemExit): - server.main() - - # Check that error was printed to stderr in JSON format - mock_print.assert_called() + with patch("sys.argv", ["arxiv-mcp"]): + with pytest.raises(ValueError, match="Test error"): + server.main() def test_async_function_definitions(self): """Test that async functions are properly defined.""" - # We can't directly test the decorated functions, but we can verify they exist - # by checking the module's global namespace or MCP registry - - # The functions should be defined in the module - vars(server) - - # Look for function names or check if they're registered with MCP - # This is a structural test to ensure the async functions are properly defined + # In FastMCP 3.0, @mcp.tool returns the original function + # so the functions should be directly accessible assert server.mcp is not None + # Verify tool functions are directly accessible as original functions + assert callable(server.search_arxiv_tool) + assert asyncio.iscoroutinefunction(server.search_arxiv_tool) + @pytest.mark.asyncio - @patch("server.mcp_handlers.search_arxiv_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_arxiv_handler") + @patch("arxiv_mcp.server.logger") async def test_search_arxiv_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_arxiv_tool function directly with logging verification.""" mock_handler.return_value = {"papers": [], "count": 0} - # Get the function from the module directly - func = getattr(server, "search_arxiv_tool", None) - if func and callable(func): - result = await func("cs.AI", 5) - assert result == {"papers": [], "count": 0} - mock_handler.assert_called_once_with("cs.AI", 5) - # Verify logging was called - mock_logger.info.assert_called_with("Searching ArXiv for query: cs.AI") + result = await server.search_arxiv_tool("cs.AI", 5) + assert result == {"papers": [], "count": 0} + mock_handler.assert_called_once_with("cs.AI", 5) + # Verify logging was called + mock_logger.info.assert_called_with("Searching ArXiv for query: cs.AI") @pytest.mark.asyncio - @patch("server.mcp_handlers.get_recent_papers_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.get_recent_papers_handler") + @patch("arxiv_mcp.server.logger") async def test_get_recent_papers_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the get_recent_papers_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "get_recent_papers_tool", None) - if func and callable(func): - result = await func("cs.AI", 5) - assert result == {"papers": []} - mock_handler.assert_called_once_with("cs.AI", 5) - # Verify logging was called - mock_logger.info.assert_called_with( - "Getting recent papers from category: cs.AI" - ) + result = await server.get_recent_papers_tool("cs.AI", 5) + assert result == {"papers": []} + mock_handler.assert_called_once_with("cs.AI", 5) + # Verify logging was called + mock_logger.info.assert_called_with( + "Getting recent papers from category: cs.AI" + ) @pytest.mark.asyncio - @patch("server.mcp_handlers.search_papers_by_author_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_papers_by_author_handler") + @patch("arxiv_mcp.server.logger") async def test_search_papers_by_author_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_papers_by_author_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "search_papers_by_author_tool", None) - if func and callable(func): - result = await func("Test Author", 10) - assert result == {"papers": []} - mock_handler.assert_called_once_with("Test Author", 10) - # Verify logging was called - mock_logger.info.assert_called_with( - "Searching papers by author: Test Author" - ) + result = await server.search_papers_by_author_tool("Test Author", 10) + assert result == {"papers": []} + mock_handler.assert_called_once_with("Test Author", 10) + # Verify logging was called + mock_logger.info.assert_called_with("Searching papers by author: Test Author") @pytest.mark.asyncio - @patch("server.mcp_handlers.search_by_title_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_by_title_handler") + @patch("arxiv_mcp.server.logger") async def test_search_by_title_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_by_title_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "search_by_title_tool", None) - if func and callable(func): - result = await func("neural networks", 10) - assert result == {"papers": []} - mock_handler.assert_called_once_with("neural networks", 10) - # Verify logging was called - mock_logger.info.assert_called_with( - "Searching papers by title: neural networks" - ) + result = await server.search_by_title_tool("neural networks", 10) + assert result == {"papers": []} + mock_handler.assert_called_once_with("neural networks", 10) + # Verify logging was called + mock_logger.info.assert_called_with( + "Searching papers by title: neural networks" + ) @pytest.mark.asyncio - @patch("server.mcp_handlers.search_by_abstract_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_by_abstract_handler") + @patch("arxiv_mcp.server.logger") async def test_search_by_abstract_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_by_abstract_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "search_by_abstract_tool", None) - if func and callable(func): - result = await func("machine learning", 10) - assert result == {"papers": []} - mock_handler.assert_called_once_with("machine learning", 10) - # Verify logging was called - mock_logger.info.assert_called_with( - "Searching papers by abstract: machine learning" - ) + result = await server.search_by_abstract_tool("machine learning", 10) + assert result == {"papers": []} + mock_handler.assert_called_once_with("machine learning", 10) + # Verify logging was called + mock_logger.info.assert_called_with( + "Searching papers by abstract: machine learning" + ) @pytest.mark.asyncio - @patch("server.mcp_handlers.search_by_subject_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_by_subject_handler") + @patch("arxiv_mcp.server.logger") async def test_search_by_subject_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_by_subject_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "search_by_subject_tool", None) - if func and callable(func): - result = await func("Computer Science", 10) - assert result == {"papers": []} - mock_handler.assert_called_once_with("Computer Science", 10) - # Verify logging was called - mock_logger.info.assert_called_with( - "Searching papers by subject: Computer Science" - ) + result = await server.search_by_subject_tool("Computer Science", 10) + assert result == {"papers": []} + mock_handler.assert_called_once_with("Computer Science", 10) + # Verify logging was called + mock_logger.info.assert_called_with( + "Searching papers by subject: Computer Science" + ) @pytest.mark.asyncio - @patch("server.mcp_handlers.search_date_range_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.search_date_range_handler") + @patch("arxiv_mcp.server.logger") async def test_search_date_range_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the search_date_range_tool function directly with logging verification.""" mock_handler.return_value = {"papers": []} - func = getattr(server, "search_date_range_tool", None) - if func and callable(func): - result = await func("2023-01-01", "2023-12-31", 10) - assert result == {"papers": []} - mock_handler.assert_called_once_with("2023-01-01", "2023-12-31", "", 10) - # Verify logging was called - mock_logger.info.assert_called_with( - "Searching papers by date range: 2023-01-01 to 2023-12-31" - ) + result = await server.search_date_range_tool("2023-01-01", "2023-12-31") + assert result == {"papers": []} + mock_handler.assert_called_once_with("2023-01-01", "2023-12-31", "", 20) + # Verify logging was called + mock_logger.info.assert_called_with( + "Searching papers by date range: 2023-01-01 to 2023-12-31" + ) @pytest.mark.asyncio - @patch("server.mcp_handlers.get_paper_details_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.get_paper_details_handler") + @patch("arxiv_mcp.server.logger") async def test_get_paper_details_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the get_paper_details_tool function directly with logging verification.""" mock_handler.return_value = {"paper": {}} - func = getattr(server, "get_paper_details_tool", None) - if func and callable(func): - result = await func("2023.12345") - assert result == {"paper": {}} - mock_handler.assert_called_once_with("2023.12345") - # Verify logging was called - mock_logger.info.assert_called_with("Getting paper details for: 2023.12345") + result = await server.get_paper_details_tool("2023.12345") + assert result == {"paper": {}} + mock_handler.assert_called_once_with("2023.12345") + # Verify logging was called + mock_logger.info.assert_called_with("Getting paper details for: 2023.12345") @pytest.mark.asyncio - @patch("server.mcp_handlers.find_similar_papers_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.find_similar_papers_handler") + @patch("arxiv_mcp.server.logger") async def test_find_similar_papers_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the find_similar_papers_tool function directly with logging verification.""" mock_handler.return_value = {"similar_papers": []} - func = getattr(server, "find_similar_papers_tool", None) - if func and callable(func): - result = await func("2023.12345", 5) - assert result == {"similar_papers": []} - mock_handler.assert_called_once_with("2023.12345", 5) - # Verify logging was called - mock_logger.info.assert_called_with( - "Finding similar papers for: 2023.12345" - ) + result = await server.find_similar_papers_tool("2023.12345", 5) + assert result == {"similar_papers": []} + mock_handler.assert_called_once_with("2023.12345", 5) + # Verify logging was called + mock_logger.info.assert_called_with("Finding papers similar to: 2023.12345") @pytest.mark.asyncio - @patch("server.mcp_handlers.export_to_bibtex_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.export_to_bibtex_handler") + @patch("arxiv_mcp.server.logger") async def test_export_to_bibtex_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the export_to_bibtex_tool function directly with logging verification.""" mock_handler.return_value = {"bibtex": ""} - func = getattr(server, "export_to_bibtex_tool", None) - if func and callable(func): - result = await func(["2023.12345"]) - assert result == {"bibtex": ""} - mock_handler.assert_called_once_with('["2023.12345"]') - # Verify logging was called - mock_logger.info.assert_called_with("Exporting to BibTeX for 1 papers") + result = await server.export_to_bibtex_tool('["2023.12345"]') + assert result == {"bibtex": ""} + mock_handler.assert_called_once_with('["2023.12345"]') + # Verify logging was called + mock_logger.info.assert_called_with("Exporting papers to BibTeX format") @pytest.mark.asyncio - @patch("server.mcp_handlers.download_paper_pdf_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.download_paper_pdf_handler") + @patch("arxiv_mcp.server.logger") async def test_download_paper_pdf_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the download_paper_pdf_tool function directly with logging verification.""" mock_handler.return_value = {"status": "success"} - func = getattr(server, "download_paper_pdf_tool", None) - if func and callable(func): - result = await func("2023.12345", "/tmp") - assert result == {"status": "success"} - mock_handler.assert_called_once_with("2023.12345", "/tmp") - # Verify logging was called - mock_logger.info.assert_called_with("Downloading PDF for paper: 2023.12345") + result = await server.download_paper_pdf_tool("2023.12345", "/tmp") + assert result == {"status": "success"} + mock_handler.assert_called_once_with("2023.12345", "/tmp") + # Verify logging was called + mock_logger.info.assert_called_with("Downloading PDF for paper: 2023.12345") @pytest.mark.asyncio - @patch("server.mcp_handlers.get_pdf_url_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.get_pdf_url_handler") + @patch("arxiv_mcp.server.logger") async def test_get_pdf_url_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the get_pdf_url_tool function directly with logging verification.""" mock_handler.return_value = {"pdf_url": ""} - func = getattr(server, "get_pdf_url_tool", None) - if func and callable(func): - result = await func("2023.12345") - assert result == {"pdf_url": ""} - mock_handler.assert_called_once_with("2023.12345") - # Verify logging was called - mock_logger.info.assert_called_with("Getting PDF URL for paper: 2023.12345") + result = await server.get_pdf_url_tool("2023.12345") + assert result == {"pdf_url": ""} + mock_handler.assert_called_once_with("2023.12345") + # Verify logging was called + mock_logger.info.assert_called_with("Getting PDF URL for paper: 2023.12345") @pytest.mark.asyncio - @patch("server.mcp_handlers.download_multiple_pdfs_handler") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers.download_multiple_pdfs_handler") + @patch("arxiv_mcp.server.logger") async def test_download_multiple_pdfs_tool_function_with_logging( self, mock_logger, mock_handler ): """Test the download_multiple_pdfs_tool function directly with logging verification.""" mock_handler.return_value = {"status": "success"} - func = getattr(server, "download_multiple_pdfs_tool", None) - if func and callable(func): - result = await func(["2023.12345"], "/tmp") - assert result == {"status": "success"} - mock_handler.assert_called_once_with('["2023.12345"]', "/tmp", 5) - # Verify logging was called - mock_logger.info.assert_called_with("Downloading multiple PDFs: 1 papers") + result = await server.download_multiple_pdfs_tool('["2023.12345"]', "/tmp") + assert result == {"status": "success"} + mock_handler.assert_called_once_with('["2023.12345"]', "/tmp", 3) + # Verify logging was called + mock_logger.info.assert_called_with( + "Downloading multiple PDFs with max_concurrent: 3" + ) - @patch("server.main") + @patch("arxiv_mcp.server.main") def test_main_name_block(self, mock_main): """Test the if __name__ == '__main__' block.""" # Use exec to simulate running the module as main code = """ -import os -import sys -sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'src')) - # Simulate the module being run as __main__ exec(''' if __name__ == "__main__": from unittest.mock import patch - with patch('server.main'): + with patch('arxiv_mcp.server.main'): pass ''') """ @@ -467,11 +437,10 @@ def test_module_execution_as_main(self): assert 'if __name__ == "__main__":' in content assert "main()" in content - @patch("server.main") + @patch("arxiv_mcp.server.main") def test_name_main_execution_block(self, mock_main): """Test that the __name__ == '__main__' block calls main().""" # Simplified test that just verifies the main block structure exists - # The actual execution happens during normal import, so we verify structure server_file = server.__file__ with open(server_file, "r") as f: content = f.read() @@ -480,10 +449,7 @@ def test_name_main_execution_block(self, mock_main): assert 'if __name__ == "__main__":' in content assert "main()" in content - # This line should be covered when we run the module normally - # Let's just ensure the test passes for now since the line exists - - @patch("server.logger") + @patch("arxiv_mcp.server.logger") def test_all_logger_calls_coverage(self, mock_logger): """Test that all logger calls can be reached for coverage.""" # Import fresh module to ensure we can patch logger @@ -500,8 +466,8 @@ def test_all_logger_calls_coverage(self, mock_logger): pass @pytest.mark.asyncio - @patch("server.mcp_handlers") - @patch("server.logger") + @patch("arxiv_mcp.server.mcp_handlers") + @patch("arxiv_mcp.server.logger") async def test_direct_tool_function_calls_for_coverage( self, mock_logger, mock_handlers ): @@ -531,17 +497,13 @@ async def test_direct_tool_function_calls_for_coverage( return_value={"status": "success"} ) - # Try to access the tool functions from the server module - # The FastMCP decorators make these functions harder to call directly - # but we can at least try to trigger them - - # Get all attributes that might be tool functions + # In FastMCP 3.0, decorated functions are the original functions + # so we can call them directly for attr_name in dir(server): if attr_name.endswith("_tool") and not attr_name.startswith("_"): func = getattr(server, attr_name, None) if callable(func) and asyncio.iscoroutinefunction(func): try: - # Try calling with minimal parameters if "search_arxiv" in attr_name: await func("test", 5) elif "recent_papers" in attr_name: @@ -555,19 +517,19 @@ async def test_direct_tool_function_calls_for_coverage( elif "subject" in attr_name: await func("subject", 5) elif "date_range" in attr_name: - await func("2023-01-01", "2023-12-31", 5) + await func("2023-01-01", "2023-12-31") elif "paper_details" in attr_name: await func("test") elif "similar" in attr_name: await func("test", 5) elif "bibtex" in attr_name: - await func(["test"]) + await func('["test"]') elif "download_paper_pdf" in attr_name: await func("test", "/tmp") elif "pdf_url" in attr_name: await func("test") elif "multiple_pdfs" in attr_name: - await func(["test"], "/tmp") + await func('["test"]', "/tmp") except Exception: # Function call failed, but logger might have been hit pass @@ -576,7 +538,7 @@ async def test_direct_tool_function_calls_for_coverage( assert mock_logger is not None @pytest.mark.asyncio - @patch("server.logger") + @patch("arxiv_mcp.server.logger") async def test_execute_all_tool_functions_for_logger_coverage(self, mock_logger): """Execute all FastMCP tool functions to hit missing logger lines.""" @@ -647,8 +609,7 @@ async def test_execute_all_tool_functions_for_logger_coverage(self, mock_logger) mock_url.return_value = {"pdf_url": ""} mock_multi.return_value = {"status": "success"} - # The tool functions exist but are wrapped by FastMCP decorators - # Try to call them directly if they exist and are callable + # In FastMCP 3.0, tool functions are original functions, call directly tool_functions = [ "search_arxiv_tool", "get_recent_papers_tool", @@ -685,19 +646,19 @@ async def test_execute_all_tool_functions_for_logger_coverage(self, mock_logger) elif "subject" in func_name: await func("Test Subject", 5) elif "date_range" in func_name: - await func("2023-01-01", "2023-12-31", 5) + await func("2023-01-01", "2023-12-31") elif "paper_details" in func_name: await func("test-id") elif "similar" in func_name: await func("test-id", 5) elif "bibtex" in func_name: - await func(["test-id"]) + await func('["test-id"]') elif "download_paper_pdf" in func_name: await func("test-id", "/tmp") elif "pdf_url" in func_name: await func("test-id") elif "multiple_pdfs" in func_name: - await func(["test-id"], "/tmp") + await func('["test-id"]', "/tmp") functions_called += 1 except Exception: @@ -760,13 +721,13 @@ async def test_tool_function_parameters_validation(self): ("search_by_title_tool", ["Machine Learning", 5]), ("search_by_abstract_tool", ["neural networks", 8]), ("search_by_subject_tool", ["computer science", 5]), - ("search_date_range_tool", ["2023-01-01", "2023-12-31", 5]), + ("search_date_range_tool", ["2023-01-01", "2023-12-31"]), ("get_paper_details_tool", ["2301.12345"]), ("find_similar_papers_tool", ["2301.12345", 5]), - ("export_to_bibtex_tool", [["2301.12345", "2301.67890"]]), + ("export_to_bibtex_tool", ['["2301.12345", "2301.67890"]']), ("download_paper_pdf_tool", ["2301.12345", "/tmp"]), ("get_pdf_url_tool", ["2301.12345"]), - ("download_multiple_pdfs_tool", [["2301.12345"], "/tmp"]), + ("download_multiple_pdfs_tool", ['["2301.12345"]', "/tmp"]), ] for tool_name, args in tool_tests: @@ -778,7 +739,7 @@ async def test_tool_function_parameters_validation(self): @pytest.mark.asyncio async def test_error_handling_in_tools(self): - """Test error handling in tool functions.""" + """Test error handling in tool functions raises ToolError.""" with patch.object(server, "mcp_handlers") as mock_handlers: # Configure handlers to raise different exceptions @@ -792,94 +753,84 @@ async def test_error_handling_in_tools(self): side_effect=ConnectionError("Network error") ) - # Test that tools handle errors gracefully - error_tests = [ - ("search_arxiv_tool", ["cs.AI", 5]), - ("get_recent_papers_tool", ["cs.AI", 5]), - ("download_paper_pdf_tool", ["test", "/tmp"]), - ] + # Test that tools raise ToolError + with pytest.raises(ToolError, match="Search error"): + await server.search_arxiv_tool("cs.AI", 5) - for tool_name, args in error_tests: - if hasattr(server, tool_name): - tool_func = getattr(server, tool_name) - try: - if asyncio.iscoroutinefunction(tool_func): - await tool_func(*args) - except Exception: - # Tools may propagate exceptions or handle them - pass + with pytest.raises(ToolError, match="Invalid parameters"): + await server.get_recent_papers_tool("cs.AI", 5) + + with pytest.raises(ToolError, match="Network error"): + await server.download_paper_pdf_tool("test", "/tmp") def test_mcp_configuration_details(self): """Test detailed MCP server configuration.""" # Test MCP instance properties mcp = server.mcp - assert mcp.name == "ArxivMCP" + assert mcp.name == "arxiv" # Test that the MCP instance has the expected structure assert hasattr(mcp, "name") # Test logging configuration logger = server.logger - assert logger.name == "server" + assert logger.name == "arxiv_mcp.server" assert logger.level <= 20 # Should be INFO or lower - @patch("server.sys.exit") - @patch("server.logger") - def test_main_exception_handling(self, mock_logger, mock_exit): + def test_main_exception_handling(self): """Test main function exception handling.""" - with patch("server.mcp") as mock_mcp: + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run.side_effect = ConnectionError("Connection failed") - server.main() - - # Should log the error and exit with error code - mock_logger.error.assert_called() - mock_exit.assert_called_with(1) + with patch("sys.argv", ["arxiv-mcp"]): + with pytest.raises(ConnectionError, match="Connection failed"): + server.main() - @patch("server.sys.exit") - @patch("server.logger") - def test_main_unexpected_exception(self, mock_logger, mock_exit): + def test_main_unexpected_exception(self): """Test main function handling of unexpected exceptions.""" - with patch("server.mcp") as mock_mcp: + with patch("arxiv_mcp.server.mcp") as mock_mcp: mock_mcp.run.side_effect = RuntimeError("Unexpected error") - server.main() + with patch("sys.argv", ["arxiv-mcp"]): + with pytest.raises(RuntimeError, match="Unexpected error"): + server.main() - # Should log the error and exit with error code - mock_logger.error.assert_called() - mock_exit.assert_called_with(1) + def test_argparse_transport_and_port(self): + """Test argparse transport and port parsing.""" - def test_environment_variable_parsing(self): - """Test environment variable parsing.""" + # Test port parsing via argparse + with patch("arxiv_mcp.server.mcp") as mock_mcp: + mock_mcp.run = MagicMock() + with patch( + "sys.argv", + [ + "arxiv-mcp", + "--transport", + "http", + "--host", + "localhost", + "--port", + "8080", + ], + ): + server.main() + mock_mcp.run.assert_called_with( + transport="http", host="localhost", port=8080 + ) - # Test port parsing - with patch.dict(os.environ, {"MCP_SSE_PORT": "8080"}): - with patch("server.mcp") as mock_mcp: - mock_mcp.run = MagicMock() - # Set other required env vars - with patch.dict( - os.environ, {"MCP_TRANSPORT": "sse", "MCP_SSE_HOST": "localhost"} - ): + # Test MCP_TRANSPORT env var fallback (no --transport arg) + with patch("arxiv_mcp.server.mcp") as mock_mcp: + mock_mcp.run = MagicMock() + with patch("sys.argv", ["arxiv-mcp"]): + with patch.dict(os.environ, {"MCP_TRANSPORT": "http"}): server.main() mock_mcp.run.assert_called_with( - transport="sse", host="localhost", port=8080 + transport="http", host="0.0.0.0", port=8000 ) - # Test invalid port handling - with patch.dict(os.environ, {"MCP_SSE_PORT": "invalid"}): - with patch("server.mcp") as mock_mcp: - mock_mcp.run = MagicMock() - with patch.dict( - os.environ, {"MCP_TRANSPORT": "sse", "MCP_SSE_HOST": "localhost"} - ): - with patch("server.sys.exit") as mock_exit: - # Should handle invalid port gracefully by exiting with error - server.main() - mock_exit.assert_called_with(1) - def test_module_level_constants(self): """Test module-level constants and configurations.""" @@ -889,9 +840,9 @@ def test_module_level_constants(self): assert hasattr(server, "logging") # Test logging configuration - assert server.logger.name == "server" + assert server.logger.name == "arxiv_mcp.server" - @patch("server.load_dotenv") + @patch("arxiv_mcp.server.load_dotenv") def test_dotenv_loading(self, mock_load_dotenv): """Test that dotenv is loaded properly.""" @@ -913,52 +864,40 @@ def test_tool_function_signatures(self): "search_by_title_tool": 2, # title, max_results "search_by_abstract_tool": 2, # abstract, max_results "search_by_subject_tool": 2, # subject, max_results - "search_date_range_tool": 3, # start_date, end_date, max_results + "search_date_range_tool": 4, # start_date, end_date, category, max_results "get_paper_details_tool": 1, # paper_id "find_similar_papers_tool": 2, # paper_id, max_results "export_to_bibtex_tool": 1, # paper_ids "download_paper_pdf_tool": 2, # paper_id, download_dir "get_pdf_url_tool": 1, # paper_id - "download_multiple_pdfs_tool": 2, # paper_ids, download_dir + "download_multiple_pdfs_tool": 3, # paper_ids, download_dir, max_concurrent } + import inspect + for tool_name, expected_params in tool_signatures.items(): if hasattr(server, tool_name): tool_func = getattr(server, tool_name) - # Check if it's a FunctionTool object - if hasattr(tool_func, "fn"): - # Check that the underlying function is callable - assert callable(tool_func.fn) - - # For async functions, check the signature - if asyncio.iscoroutinefunction(tool_func.fn): - import inspect - - sig = inspect.signature(tool_func.fn) - actual_params = len(sig.parameters) - # Parameters might include self or other injected params - assert actual_params >= expected_params - else: - # Direct function - check if callable - assert callable(tool_func) - - # For async functions, check the signature - if asyncio.iscoroutinefunction(tool_func): - import inspect + # In FastMCP 3.0, decorated functions are original functions + assert callable(tool_func) - sig = inspect.signature(tool_func) - actual_params = len(sig.parameters) - # Parameters might include self or other injected params - assert actual_params >= expected_params + if asyncio.iscoroutinefunction(tool_func): + sig = inspect.signature(tool_func) + actual_params = len(sig.parameters) + assert actual_params >= expected_params def test_server_startup_sequence(self): """Test the server startup sequence.""" - with patch("server.load_dotenv"), patch("server.mcp") as mock_mcp: + with ( + patch("arxiv_mcp.server.load_dotenv"), + patch("arxiv_mcp.server.mcp") as mock_mcp, + ): mock_mcp.run = MagicMock() # Test startup with default configuration - server.main() + with patch("sys.argv", ["arxiv-mcp"]): + server.main() # Verify startup sequence mock_mcp.run.assert_called_once() @@ -979,17 +918,14 @@ async def test_concurrent_tool_execution(self): return_value={"papers": []} ) - # Create concurrent tasks + # In FastMCP 3.0, call functions directly (no .fn()) tasks = [] if hasattr(server, "search_arxiv_tool"): - tool = server.search_arxiv_tool - tasks.append(tool.fn("cs.AI", 5)) + tasks.append(server.search_arxiv_tool("cs.AI", 5)) if hasattr(server, "get_recent_papers_tool"): - tool = server.get_recent_papers_tool - tasks.append(tool.fn("cs.LG", 3)) + tasks.append(server.get_recent_papers_tool("cs.LG", 3)) if hasattr(server, "search_papers_by_author_tool"): - tool = server.search_papers_by_author_tool - tasks.append(tool.fn("Test Author", 5)) + tasks.append(server.search_papers_by_author_tool("Test Author", 5)) # Execute concurrently if tasks: diff --git a/clio-kit-mcp-servers/arxiv/tests/test_text_search.py b/clio-kit-mcp-servers/arxiv/tests/test_text_search.py index 95050fa6..aa305428 100644 --- a/clio-kit-mcp-servers/arxiv/tests/test_text_search.py +++ b/clio-kit-mcp-servers/arxiv/tests/test_text_search.py @@ -3,13 +3,8 @@ """ import pytest -import sys -import os -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.text_search import ( +from arxiv_mcp.capabilities.text_search import ( search_by_title, search_by_abstract, search_papers_by_author, diff --git a/clio-kit-mcp-servers/arxiv/uv.lock b/clio-kit-mcp-servers/arxiv/uv.lock index e4c90fa2..f32e8eb5 100644 --- a/clio-kit-mcp-servers/arxiv/uv.lock +++ b/clio-kit-mcp-servers/arxiv/uv.lock @@ -46,7 +46,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "httpx", specifier = ">=0.24.0" }, ] @@ -436,18 +436,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.2" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/cc/2e/8c45ef5b00bd48d7cabbf6f90b7f12df4c232755cd46e6dbc6690f9ac0c5/cyclopts-3.22.2.tar.gz", hash = "sha256:d3495231af6ae86479579777d212ddf77b113200f828badeaf401162ed87227d", size = 74520, upload-time = "2025-07-09T12:21:46.866Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/5b/5939e05d87def1612c494429bee705d6b852fad1d21dd2dee1e3ce39997e/cyclopts-3.22.2-py3-none-any.whl", hash = "sha256:6681b0815fa2de2bccc364468fd25b15aa9617cb505c0b16ca62e2b18a57619e", size = 84578, upload-time = "2025-07-09T12:21:44.878Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -513,27 +514,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -657,6 +664,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.24.0" @@ -731,7 +747,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -745,11 +761,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -836,6 +854,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -892,15 +923,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -915,19 +946,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -1579,6 +1597,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d2/e2/dc81b1bd1dcfe91735810265e9d26bc8ec5da45b4c0f6237e286819194c3/uvicorn-0.35.0-py3-none-any.whl", hash = "sha256:197535216b25ff9b785e29a0b79199f55222193d47f820816e7da751e9bc8d4a", size = 66406, upload-time = "2025-06-28T16:15:44.816Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/chronolog/.claude-plugin/plugin.json b/clio-kit-mcp-servers/chronolog/.claude-plugin/plugin.json new file mode 100644 index 00000000..fe583999 --- /dev/null +++ b/clio-kit-mcp-servers/chronolog/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-chronolog", + "description": "ChronoLog MCP server implementation using Model Context Protocol", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/chronolog/.mcp.json b/clio-kit-mcp-servers/chronolog/.mcp.json new file mode 100644 index 00000000..a4601086 --- /dev/null +++ b/clio-kit-mcp-servers/chronolog/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-chronolog": { + "command": "uvx", + "args": [ + "clio-kit", + "chronolog" + ] + } +} diff --git a/clio-kit-mcp-servers/chronolog/pyproject.toml b/clio-kit-mcp-servers/chronolog/pyproject.toml index e1a00dc6..067ae204 100644 --- a/clio-kit-mcp-servers/chronolog/pyproject.toml +++ b/clio-kit-mcp-servers/chronolog/pyproject.toml @@ -26,7 +26,7 @@ keywords = [ "distributed logging", ] dependencies = [ - "fastmcp", + "fastmcp>=3.0.0rc2", "python-dotenv", "google-genai", "h5py", @@ -51,5 +51,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/chronomcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/chronolog/server.json b/clio-kit-mcp-servers/chronolog/server.json new file mode 100644 index 00000000..4d7f6340 --- /dev/null +++ b/clio-kit-mcp-servers/chronolog/server.json @@ -0,0 +1,51 @@ +{ + "name": "io.github.iowarp/chronolog-mcp", + "description": "ChronoLog MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "chronolog" + ] + }, + "tools": [ + { + "name": "start_chronolog", + "description": "Connect to ChronoLog, create a chronicle, and acquire a story handle." + }, + { + "name": "record_interaction", + "description": "Log a user message and LLM response to the active ChronoLog story." + }, + { + "name": "stop_chronolog", + "description": "Release the story handle and disconnect from ChronoLog." + }, + { + "name": "retrieve_interaction", + "description": "Retrieve logged records from a chronicle and story, with optional time filtering." + } + ], + "resources": [ + { + "uri": "chronolog://status", + "name": "chronolog_status", + "description": "Current ChronoLog system status." + } + ], + "prompts": [ + { + "name": "logging_workflow", + "description": "Guided workflow for querying and analyzing ChronoLog entries." + } + ], + "tags": [ + "logging", + "distributed-systems", + "hpc", + "time-series" + ] +} diff --git a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/record_handler.py b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/record_handler.py index d340aa7b..f1eeb73b 100644 --- a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/record_handler.py +++ b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/record_handler.py @@ -1,11 +1,16 @@ # capabilities/record_interaction.py +from fastmcp.exceptions import ToolError + from chronomcp.utils import config async def record_interaction(user_message: str, assistant_message: str) -> str: + """Log a user/assistant interaction to the active ChronoLog story.""" if config._story_handle is None: - return "No active ChronoLog session. Please call start_chronolog first." + raise ToolError( + "No active ChronoLog session. Please call start_chronolog first." + ) config._story_handle.log_event( f"user: {user_message}, assistant: {assistant_message}" diff --git a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/start_handler.py b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/start_handler.py index 390e3bf8..bfb9add7 100644 --- a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/start_handler.py +++ b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/start_handler.py @@ -1,29 +1,34 @@ # capabilities/start_chronolog.py +from fastmcp.exceptions import ToolError + from chronomcp.utils import config async def start_chronolog( chronicle_name: str | None = None, story_name: str | None = None ) -> str: + """Connect to ChronoLog and acquire a story handle for logging.""" chronicle = chronicle_name or config.DEFAULT_CHRONICLE story = story_name or config.DEFAULT_STORY ret = config.client.Connect() if ret != 0: - return f"Failed to connect to ChronoLog: {ret}" + raise ToolError(f"Failed to connect to ChronoLog: {ret}") attrs: dict[str, str] = {} ret = config.client.CreateChronicle(chronicle, attrs, 1) if ret != 0: config.client.Disconnect() - return f"Failed to create chronicle '{chronicle}': {ret}" + raise ToolError(f"Failed to create chronicle '{chronicle}': {ret}") ret, handle = config.client.AcquireStory(chronicle, story, attrs, 1) if ret != 0: config.client.ReleaseStory(chronicle, story) config.client.Disconnect() - return f"Failed to acquire story '{story}' in chronicle '{chronicle}': {ret}" + raise ToolError( + f"Failed to acquire story '{story}' in chronicle '{chronicle}': {ret}" + ) config._active_chronicle = chronicle config._active_story = story diff --git a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/stop_handler.py b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/stop_handler.py index 0621cfa1..2ee018fe 100644 --- a/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/stop_handler.py +++ b/clio-kit-mcp-servers/chronolog/src/chronomcp/capabilities/stop_handler.py @@ -1,22 +1,22 @@ # capabilities/stop_chronolog.py +from fastmcp.exceptions import ToolError + from chronomcp.utils import config async def stop_chronolog() -> str: - """ - Release the story and disconnect from ChronoLog. - """ + """Release the story and disconnect from ChronoLog.""" if config._story_handle is None: - return "No active ChronoLog session to stop." + raise ToolError("No active ChronoLog session to stop.") ret = config.client.ReleaseStory(config._active_chronicle, config._active_story) if ret != 0: - return f"Failed to release story '{config._active_story}': {ret}" + raise ToolError(f"Failed to release story '{config._active_story}': {ret}") ret = config.client.Disconnect() if ret != 0: - return f"Failed to disconnect from ChronoLog: {ret}" + raise ToolError(f"Failed to disconnect from ChronoLog: {ret}") config._active_chronicle = None config._active_story = None diff --git a/clio-kit-mcp-servers/chronolog/src/chronomcp/server.py b/clio-kit-mcp-servers/chronolog/src/chronomcp/server.py index b749a983..48047b79 100644 --- a/clio-kit-mcp-servers/chronolog/src/chronomcp/server.py +++ b/clio-kit-mcp-servers/chronolog/src/chronomcp/server.py @@ -1,82 +1,114 @@ # server.py -import utils.config as config +import os from typing import Optional + from fastmcp import FastMCP -from capabilities.start_handler import start_chronolog as _start -from capabilities.record_handler import record_interaction as _record -from capabilities.stop_handler import stop_chronolog as _stop -from capabilities.retrieve_handler import retrieve_interaction as _retrieve +from fastmcp.prompts import Message + +from chronomcp.utils import config +from chronomcp.capabilities.start_handler import start_chronolog as _start +from chronomcp.capabilities.record_handler import record_interaction as _record +from chronomcp.capabilities.stop_handler import stop_chronolog as _stop +from chronomcp.capabilities.retrieve_handler import retrieve_interaction as _retrieve mcp: FastMCP = config.mcp -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"chronolog", "logging"}, +) async def start_chronolog( chronicle_name: Optional[str] = None, story_name: Optional[str] = None -): - """ - Connects to ChronoLog, creates a chronicle, and acquires a story handle for logging interactions. - - Args: - chronicle_name (str, optional): Name of the chronicle to create or connect to. Defaults to config.DEFAULT_CHRONICLE. - story_name (str, optional): Name of the story to acquire. Defaults to config.DEFAULT_STORY. - - Returns: - str: Confirmation message with chronicle and story identifiers. - """ +) -> str: + """Connect to ChronoLog, create a chronicle, and acquire a story handle.""" return await _start(chronicle_name, story_name) -@mcp.tool() -async def record_interaction(user_message: str, assistant_message: str): - """ - Logs user messages and LLM responses to the active story with structured event formatting. - - Args: - user_message (str): The user message content to record. - assistant_message (str): The assistant (LLM) response to record. - - Returns: - str: Confirmation of successful event logging with timestamp information. - """ +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"chronolog", "logging"}, +) +async def record_interaction(user_message: str, assistant_message: str) -> str: + """Log a user message and LLM response to the active ChronoLog story.""" return await _record(user_message, assistant_message) -@mcp.tool() -async def stop_chronolog(): - """ - Releases the story handle and cleanly disconnects from ChronoLog system. - - Returns: - str: Confirmation of clean shutdown and resource cleanup. - """ +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"chronolog", "logging"}, +) +async def stop_chronolog() -> str: + """Release the story handle and disconnect from ChronoLog.""" return await _stop() -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"chronolog", "logging"}, +) async def retrieve_interaction( chronicle_name: Optional[str] = None, story_name: Optional[str] = None, start_time: Optional[str] = None, end_time: Optional[str] = None, -): - """ - Extracts logged records from specified chronicle and story, generates timestamped output files with filtering options. - - Args: - chronicle_name (str, optional): Name of the chronicle to retrieve from. Defaults to config.DEFAULT_CHRONICLE. - story_name (str, optional): Name of the story to retrieve from. Defaults to config.DEFAULT_STORY. - start_time (str, optional): Start time for filtering records (YYYY-MM-DD HH:MM:SS or similar). - end_time (str, optional): End time for filtering records (YYYY-MM-DD HH:MM:SS or similar). - - Returns: - str: Generated text file with interaction history or error message if no records found. - """ +) -> str: + """Retrieve logged records from a chronicle and story, with optional time filtering.""" return await _retrieve(chronicle_name, story_name, start_time, end_time) -def main(): - mcp.run() +@mcp.resource("chronolog://status") +def chronolog_status() -> dict: + """Current ChronoLog system status.""" + return { + "service": "chronolog", + "status": "ready", + "description": "Distributed logging system for scientific computing", + } + + +@mcp.prompt() +def logging_workflow(time_range: str = "last 1 hour") -> list[Message]: + """Guided workflow for querying and analyzing ChronoLog entries.""" + return [ + Message( + f"I need to analyze ChronoLog entries from {time_range}. " + "Query the logs, summarize key events, and identify any anomalies." + ), + ] + + +def main() -> None: + """Main entry point for the Chronolog MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Chronolog MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/chronolog/src/chronomcp/utils/config.py b/clio-kit-mcp-servers/chronolog/src/chronomcp/utils/config.py index e600208e..77769191 100644 --- a/clio-kit-mcp-servers/chronolog/src/chronomcp/utils/config.py +++ b/clio-kit-mcp-servers/chronolog/src/chronomcp/utils/config.py @@ -3,7 +3,7 @@ from dotenv import load_dotenv import logging import py_chronolog_client -from mcp.server.fastmcp import FastMCP +from fastmcp import FastMCP # load .env and set up logging load_dotenv() @@ -33,7 +33,13 @@ client = py_chronolog_client.Client(client_conf) # MCP server instance -mcp: FastMCP = FastMCP("chronologMCP") +mcp: FastMCP = FastMCP( + "chronolog", + instructions=( + "Manages ChronoLog distributed logging system. " + "Record events, query logs by time range, and monitor log status." + ), +) # session state _active_chronicle = "" diff --git a/clio-kit-mcp-servers/chronolog/tests/test_helpers.py b/clio-kit-mcp-servers/chronolog/tests/test_helpers.py index 45f0581f..c8ff15d6 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_helpers.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_helpers.py @@ -1,11 +1,6 @@ """Tests for Chronolog utility helper functions.""" import pytest -import sys -import os - -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from chronomcp.utils.helpers import parse_time_arg from .test_utils import are_chronolog_processes_running diff --git a/clio-kit-mcp-servers/chronolog/tests/test_integration.py b/clio-kit-mcp-servers/chronolog/tests/test_integration.py index a12238c0..cbbf4148 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_integration.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_integration.py @@ -1,22 +1,28 @@ """Integration tests for Chronolog MCP Server.""" import pytest -import sys -import os import time import random -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +try: + from chronomcp.capabilities import ( + record_handler, + retrieve_handler, + start_handler, + stop_handler, + ) + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False -from chronomcp.capabilities import ( - record_handler, - retrieve_handler, - start_handler, - stop_handler, -) from .test_utils import are_chronolog_processes_running +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + class TestIntegration: """Integration tests for the full Chronolog MCP stack""" diff --git a/clio-kit-mcp-servers/chronolog/tests/test_record_handler.py b/clio-kit-mcp-servers/chronolog/tests/test_record_handler.py index 045a2423..81e9dc07 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_record_handler.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_record_handler.py @@ -1,23 +1,37 @@ """Tests for Chronolog record interaction capabilities.""" import pytest -import sys -import os import time import random -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +try: + from fastmcp.exceptions import ToolError + + from chronomcp.capabilities.record_handler import record_interaction + from chronomcp.capabilities.start_handler import start_chronolog + from chronomcp.capabilities.stop_handler import stop_chronolog + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False -from chronomcp.capabilities.record_handler import record_interaction -from chronomcp.capabilities.start_handler import start_chronolog -from chronomcp.capabilities.stop_handler import stop_chronolog from .test_utils import are_chronolog_processes_running +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + class TestRecordHandler: """Test record interaction functionality""" + @pytest.mark.asyncio + async def test_record_without_session_raises(self): + """Test that recording without an active session raises ToolError""" + with pytest.raises(ToolError, match="No active ChronoLog session"): + await record_interaction("test", "test") + @pytest.mark.asyncio async def test_record_interaction_basic(self): """Test basic record interaction""" diff --git a/clio-kit-mcp-servers/chronolog/tests/test_retrieve_handler.py b/clio-kit-mcp-servers/chronolog/tests/test_retrieve_handler.py index 1ce51a15..2191fa63 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_retrieve_handler.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_retrieve_handler.py @@ -1,20 +1,26 @@ """Tests for Chronolog retrieve interaction capabilities.""" import pytest -import sys -import os import time import random -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +try: + from chronomcp.capabilities.retrieve_handler import retrieve_interaction + from chronomcp.capabilities.record_handler import record_interaction + from chronomcp.capabilities.start_handler import start_chronolog + from chronomcp.capabilities.stop_handler import stop_chronolog + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False -from chronomcp.capabilities.retrieve_handler import retrieve_interaction -from chronomcp.capabilities.record_handler import record_interaction -from chronomcp.capabilities.start_handler import start_chronolog -from chronomcp.capabilities.stop_handler import stop_chronolog from .test_utils import are_chronolog_processes_running +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + class TestRetrieveHandler: """Test retrieve interaction functionality""" diff --git a/clio-kit-mcp-servers/chronolog/tests/test_server.py b/clio-kit-mcp-servers/chronolog/tests/test_server.py new file mode 100644 index 00000000..5b2e30be --- /dev/null +++ b/clio-kit-mcp-servers/chronolog/tests/test_server.py @@ -0,0 +1,113 @@ +"""Tests for Chronolog MCP server configuration and FastMCP 3.0 features.""" + +import pytest + +try: + from chronomcp.server import ( + mcp, + start_chronolog, + record_interaction, + stop_chronolog, + retrieve_interaction, + chronolog_status, + logging_workflow, + ) + from fastmcp.prompts import Message + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False + +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + + +class TestServerConfig: + """Test FastMCP server configuration""" + + def test_server_name(self): + """Test that the MCP server has the correct name""" + assert mcp.name == "chronolog" + + def test_server_instructions(self): + """Test that the MCP server has instructions set""" + assert mcp.instructions is not None + assert "ChronoLog" in mcp.instructions + assert "distributed logging" in mcp.instructions.lower() + + +class TestToolDecorators: + """Test that tools are properly decorated with FastMCP 3.0 features""" + + def test_tools_are_original_functions(self): + """In FastMCP 3.0, @mcp.tool() returns the original function""" + assert callable(start_chronolog) + assert callable(record_interaction) + assert callable(stop_chronolog) + assert callable(retrieve_interaction) + + def test_start_chronolog_is_async(self): + """Test that start_chronolog is still an async function""" + import asyncio + + assert asyncio.iscoroutinefunction(start_chronolog) + + def test_record_interaction_is_async(self): + """Test that record_interaction is still an async function""" + import asyncio + + assert asyncio.iscoroutinefunction(record_interaction) + + def test_stop_chronolog_is_async(self): + """Test that stop_chronolog is still an async function""" + import asyncio + + assert asyncio.iscoroutinefunction(stop_chronolog) + + def test_retrieve_interaction_is_async(self): + """Test that retrieve_interaction is still an async function""" + import asyncio + + assert asyncio.iscoroutinefunction(retrieve_interaction) + + +class TestResource: + """Test the chronolog://status resource""" + + def test_chronolog_status_returns_dict(self): + """Test that the status resource returns expected data""" + result = chronolog_status() + assert isinstance(result, dict) + assert result["service"] == "chronolog" + assert result["status"] == "ready" + assert "description" in result + + +class TestPrompt: + """Test the logging_workflow prompt""" + + def test_logging_workflow_default(self): + """Test the prompt with default time range""" + messages = logging_workflow() + assert isinstance(messages, list) + assert len(messages) == 1 + assert isinstance(messages[0], Message) + + def test_logging_workflow_custom_range(self): + """Test the prompt with custom time range""" + messages = logging_workflow(time_range="last 24 hours") + assert isinstance(messages, list) + assert len(messages) == 1 + assert isinstance(messages[0], Message) + + +class TestMainFunction: + """Test the main entry point""" + + def test_main_function_exists(self): + """Test that main function exists and is callable""" + from chronomcp.server import main + + assert callable(main) diff --git a/clio-kit-mcp-servers/chronolog/tests/test_start_handler.py b/clio-kit-mcp-servers/chronolog/tests/test_start_handler.py index f1044cc2..644504b0 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_start_handler.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_start_handler.py @@ -1,17 +1,23 @@ """Tests for Chronolog start session capabilities.""" import pytest -import sys -import os import time import random -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +try: + from chronomcp.capabilities.start_handler import start_chronolog + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False -from chronomcp.capabilities.start_handler import start_chronolog from .test_utils import are_chronolog_processes_running +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + class TestStartHandler: """Test ChronoLog session start functionality""" diff --git a/clio-kit-mcp-servers/chronolog/tests/test_stop_handler.py b/clio-kit-mcp-servers/chronolog/tests/test_stop_handler.py index 95fa9d4e..974e4449 100644 --- a/clio-kit-mcp-servers/chronolog/tests/test_stop_handler.py +++ b/clio-kit-mcp-servers/chronolog/tests/test_stop_handler.py @@ -1,25 +1,49 @@ """Tests for Chronolog stop session capabilities.""" import pytest -import sys -import os -# Add src to path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +try: + from fastmcp.exceptions import ToolError + + from chronomcp.capabilities.stop_handler import stop_chronolog + + HAS_DEPENDENCIES = True +except ImportError: + HAS_DEPENDENCIES = False -from chronomcp.capabilities.stop_handler import stop_chronolog from .test_utils import are_chronolog_processes_running +pytestmark = pytest.mark.skipif( + not HAS_DEPENDENCIES, + reason="ChronoLog system dependencies not available", +) + class TestStopHandler: """Test ChronoLog session stop functionality""" + @pytest.mark.asyncio + async def test_stop_chronolog_no_session_raises(self): + """Test that stopping without an active session raises ToolError""" + with pytest.raises(ToolError, match="No active ChronoLog session"): + await stop_chronolog() + @pytest.mark.asyncio async def test_stop_chronolog_basic(self): - """Test basic stop functionality""" + """Test basic stop functionality with active session""" if not are_chronolog_processes_running(): pytest.skip("ChronoLog processes are not running") + from chronomcp.capabilities.start_handler import start_chronolog + import time + import random + + chronicle_name = ( + f"test_chronicle_{int(time.time())}_{random.randint(1000, 9999)}" + ) + story_name = f"test_story_{int(time.time())}_{random.randint(1000, 9999)}" + await start_chronolog(chronicle_name, story_name) + result = await stop_chronolog() assert isinstance(result, str) assert "ChronoLog session stopped" in result diff --git a/clio-kit-mcp-servers/chronolog/uv.lock b/clio-kit-mcp-servers/chronolog/uv.lock index 2b640844..5d3c2d4d 100644 --- a/clio-kit-mcp-servers/chronolog/uv.lock +++ b/clio-kit-mcp-servers/chronolog/uv.lock @@ -241,7 +241,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "google-genai" }, { name = "h11", specifier = ">=0.16.0" }, { name = "h5py" }, @@ -326,18 +326,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.5" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/a3/d5/24c6c894f3833bc93d4944c2064309dfd633c0becf93e16fc79d76edd388/cyclopts-3.22.5.tar.gz", hash = "sha256:fa2450b9840abc41c6aa37af5eaeafc7a1264e08054e3a2fe39d49aa154f592a", size = 74890, upload-time = "2025-07-31T18:18:37.336Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/df/e5/a7b6db64f08cfe065e531ec6b508fa7dac704fab70d05adb5bc0c2c1d1b6/cyclopts-3.22.5-py3-none-any.whl", hash = "sha256:92efb4a094d9812718d7efe0bffa319a19cb661f230dbf24406c18cd8809fb82", size = 84994, upload-time = "2025-07-31T18:18:35.939Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -403,27 +404,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -612,6 +619,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.0" @@ -686,7 +702,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -700,11 +716,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -886,6 +904,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -933,15 +964,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -956,19 +987,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pyasn1" version = "0.6.1" @@ -1640,6 +1658,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d2/e2/dc81b1bd1dcfe91735810265e9d26bc8ec5da45b4c0f6237e286819194c3/uvicorn-0.35.0-py3-none-any.whl", hash = "sha256:197535216b25ff9b785e29a0b79199f55222193d47f820816e7da751e9bc8d4a", size = 66406, upload-time = "2025-06-28T16:15:44.816Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/compression/.claude-plugin/plugin.json b/clio-kit-mcp-servers/compression/.claude-plugin/plugin.json new file mode 100644 index 00000000..e17fd5d4 --- /dev/null +++ b/clio-kit-mcp-servers/compression/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-compression", + "description": "Compression MCP server implementation using Model Context Protocol", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/compression/.mcp.json b/clio-kit-mcp-servers/compression/.mcp.json new file mode 100644 index 00000000..8f3f3614 --- /dev/null +++ b/clio-kit-mcp-servers/compression/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-compression": { + "command": "uvx", + "args": [ + "clio-kit", + "compression" + ] + } +} diff --git a/clio-kit-mcp-servers/compression/README.md b/clio-kit-mcp-servers/compression/README.md index 3430e74a..0ea22f7f 100644 --- a/clio-kit-mcp-servers/compression/README.md +++ b/clio-kit-mcp-servers/compression/README.md @@ -141,13 +141,75 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\compression run comp ## Capabilities -### `compress_file` -**Description**: Compress a file using gzip compression with detailed statistics and performance analytics. Supports all file types with comprehensive error handling. +### `compress_file_tool` +**Description**: Compress a file using gzip. Returns original/compressed sizes and compression ratio. +**Hints**: idempotent +**Tags**: compression, file-io -**Parameters**: -- `file_path` (str): Absolute path to the file to compress +### `decompress_file_tool` +**Description**: Decompress a gzip-compressed (.gz) file back to its original form. +**Hints**: idempotent +**Tags**: decompression, file-io -**Returns**: dict: Dictionary containing compression results with detailed statistics including original size, compressed size, compression ratio, and output file path. +### Resources + +- `compression://capabilities` - Supported compression formats and their capabilities. + +### Prompts + +- **compress_workflow**: Guided workflow for compressing a file and verifying the result. +## Claude Code + +```bash +claude mcp add clio-compression -- uvx clio-kit compression +``` + +Or install via the CLIO Kit plugin marketplace: + +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-compression@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-compression": { + "command": "uvx", + "args": [ + "clio-kit", + "compression" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-compression": { + "command": "uvx", + "args": [ + "clio-kit", + "compression" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Log File Compression and Storage Optimization diff --git a/clio-kit-mcp-servers/compression/pyproject.toml b/clio-kit-mcp-servers/compression/pyproject.toml index 95660f09..1bc18212 100644 --- a/clio-kit-mcp-servers/compression/pyproject.toml +++ b/clio-kit-mcp-servers/compression/pyproject.toml @@ -12,8 +12,7 @@ authors = [ keywords = ["compression", "gzip", "storage", "archival", "backup", "analytics", "statistics"] dependencies = [ - "fastmcp>=2.13.0", - "python-dotenv>=1.0.0", + "fastmcp>=3.0.0rc2", ] [project.urls] @@ -21,7 +20,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -compression-mcp = "server:main" +compression-mcp = "compression_mcp.server:main" [dependency-groups] dev = [ @@ -33,5 +32,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/compression_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/compression/server.json b/clio-kit-mcp-servers/compression/server.json new file mode 100644 index 00000000..f9de992e --- /dev/null +++ b/clio-kit-mcp-servers/compression/server.json @@ -0,0 +1,43 @@ +{ + "name": "io.github.iowarp/compression-mcp", + "description": "Compression MCP server implementation using Model Context Protocol", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "compression" + ] + }, + "tools": [ + { + "name": "compress_file_tool", + "description": "Compress a file using gzip. Returns original/compressed sizes and compression ratio." + }, + { + "name": "decompress_file_tool", + "description": "Decompress a gzip-compressed (.gz) file back to its original form." + } + ], + "resources": [ + { + "uri": "compression://capabilities", + "name": "compression_capabilities", + "description": "Supported compression formats and their capabilities." + } + ], + "prompts": [ + { + "name": "compress_workflow", + "description": "Guided workflow for compressing a file and verifying the result." + } + ], + "tags": [ + "compression", + "gzip", + "file-operations", + "data-management" + ] +} diff --git a/clio-kit-mcp-servers/compression/src/__init__.py b/clio-kit-mcp-servers/compression/src/__init__.py deleted file mode 100644 index 2d37184b..00000000 --- a/clio-kit-mcp-servers/compression/src/__init__.py +++ /dev/null @@ -1,4 +0,0 @@ -""" -Compression MCP Server -A Model Context Protocol server for file compression capabilities. -""" diff --git a/clio-kit-mcp-servers/compression/src/capabilities/compression_base.py b/clio-kit-mcp-servers/compression/src/capabilities/compression_base.py deleted file mode 100644 index 8af9e1aa..00000000 --- a/clio-kit-mcp-servers/compression/src/capabilities/compression_base.py +++ /dev/null @@ -1,76 +0,0 @@ -""" -Base utilities for compression capabilities. -""" - -import gzip -import os -import shutil -from typing import Dict, Any -import logging - -logger = logging.getLogger(__name__) - - -async def compress_file(file_path: str) -> Dict[str, Any]: - """ - Compress a file using gzip compression. - - Args: - file_path: Path to the file to compress - - Returns: - Dictionary containing compression results - """ - try: - if not os.path.exists(file_path): - raise FileNotFoundError(f"File not found: {file_path}") - - output_path = file_path + ".gz" - - # Get original file size - original_size = os.path.getsize(file_path) - - # Compress the file - with open(file_path, "rb") as f_in: - with gzip.open(output_path, "wb") as f_out: - shutil.copyfileobj(f_in, f_out) - - # Get compressed file size - compressed_size = os.path.getsize(output_path) - - # Calculate compression ratio - if original_size == 0: - compression_ratio = 0.0 - else: - compression_ratio = (1 - (compressed_size / original_size)) * 100 - - logger.info( - f"Successfully compressed {file_path} with {compression_ratio:.2f}% reduction" - ) - - return { - "content": [ - { - "text": f"File compressed successfully!\n\nOriginal file: {file_path}\nCompressed file: {output_path}\nOriginal size: {original_size:,} bytes\nCompressed size: {compressed_size:,} bytes\nCompression ratio: {compression_ratio:.2f}%" - } - ], - "_meta": { - "tool": "compress_file", - "original_file": file_path, - "compressed_file": output_path, - "original_size": original_size, - "compressed_size": compressed_size, - "compression_ratio": compression_ratio, - }, - "isError": False, - } - - except FileNotFoundError as e: - logger.error(f"File not found: {str(e)}") - raise Exception(f"File not found: {str(e)}") - except PermissionError as e: - logger.error(f"Permission denied: {str(e)}") - raise Exception(f"Permission denied: {str(e)}") - except Exception as e: - logger.error(f"Compression failed: {str(e)}") - raise Exception(f"Compression failed: {str(e)}") diff --git a/clio-kit-mcp-servers/compression/src/compression_mcp/__init__.py b/clio-kit-mcp-servers/compression/src/compression_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/compression/src/capabilities/__init__.py b/clio-kit-mcp-servers/compression/src/compression_mcp/capabilities/__init__.py similarity index 100% rename from clio-kit-mcp-servers/compression/src/capabilities/__init__.py rename to clio-kit-mcp-servers/compression/src/compression_mcp/capabilities/__init__.py diff --git a/clio-kit-mcp-servers/compression/src/compression_mcp/capabilities/compression_base.py b/clio-kit-mcp-servers/compression/src/compression_mcp/capabilities/compression_base.py new file mode 100644 index 00000000..3d2ed029 --- /dev/null +++ b/clio-kit-mcp-servers/compression/src/compression_mcp/capabilities/compression_base.py @@ -0,0 +1,99 @@ +"""Base utilities for compression capabilities.""" + +import gzip +import os +import shutil +import logging + +logger = logging.getLogger(__name__) + + +async def compress_file(file_path: str) -> dict: + """Compress a file using gzip compression. + + Args: + file_path: Path to the file to compress + + Returns: + Dictionary containing compression results + + Raises: + FileNotFoundError: If the file does not exist + PermissionError: If access is denied + """ + if not os.path.exists(file_path): + raise FileNotFoundError(f"File not found: {file_path}") + + output_path = file_path + ".gz" + original_size = os.path.getsize(file_path) + + with open(file_path, "rb") as f_in: + with gzip.open(output_path, "wb") as f_out: + shutil.copyfileobj(f_in, f_out) + + compressed_size = os.path.getsize(output_path) + + if original_size == 0: + compression_ratio = 0.0 + else: + compression_ratio = (1 - (compressed_size / original_size)) * 100 + + logger.info( + f"Successfully compressed {file_path} with {compression_ratio:.2f}% reduction" + ) + + return { + "original_file": file_path, + "compressed_file": output_path, + "original_size": original_size, + "compressed_size": compressed_size, + "compression_ratio": round(compression_ratio, 2), + "message": ( + f"Compressed {os.path.basename(file_path)}: " + f"{original_size:,} → {compressed_size:,} bytes " + f"({compression_ratio:.1f}% reduction)" + ), + } + + +async def decompress_file(file_path: str) -> dict: + """Decompress a gzip-compressed file. + + Args: + file_path: Path to the .gz file to decompress + + Returns: + Dictionary containing decompression results + + Raises: + FileNotFoundError: If the file does not exist + ValueError: If the file is not a .gz file + PermissionError: If access is denied + """ + if not os.path.exists(file_path): + raise FileNotFoundError(f"File not found: {file_path}") + + if not file_path.endswith(".gz"): + raise ValueError(f"Not a gzip file (expected .gz extension): {file_path}") + + output_path = file_path[:-3] # Remove .gz extension + compressed_size = os.path.getsize(file_path) + + with gzip.open(file_path, "rb") as f_in: + with open(output_path, "wb") as f_out: + shutil.copyfileobj(f_in, f_out) + + decompressed_size = os.path.getsize(output_path) + + logger.info(f"Successfully decompressed {file_path}") + + return { + "compressed_file": file_path, + "decompressed_file": output_path, + "compressed_size": compressed_size, + "decompressed_size": decompressed_size, + "message": ( + f"Decompressed {os.path.basename(file_path)}: " + f"{compressed_size:,} → {decompressed_size:,} bytes" + ), + } diff --git a/clio-kit-mcp-servers/compression/src/compression_mcp/mcp_handlers.py b/clio-kit-mcp-servers/compression/src/compression_mcp/mcp_handlers.py new file mode 100644 index 00000000..f77828fa --- /dev/null +++ b/clio-kit-mcp-servers/compression/src/compression_mcp/mcp_handlers.py @@ -0,0 +1,40 @@ +"""MCP handlers for compression capabilities.""" + +from fastmcp.exceptions import ToolError +from .capabilities.compression_base import compress_file, decompress_file + + +async def compress_file_handler(file_path: str) -> dict: + """Handler wrapping the file compression capability for MCP. + + Args: + file_path: Path to the file to compress + + Returns: + Compression results dictionary + + Raises: + ToolError: On any compression failure + """ + try: + return await compress_file(file_path) + except Exception as e: + raise ToolError(str(e)) from e + + +async def decompress_file_handler(file_path: str) -> dict: + """Handler wrapping the file decompression capability for MCP. + + Args: + file_path: Path to the .gz file to decompress + + Returns: + Decompression results dictionary + + Raises: + ToolError: On any decompression failure + """ + try: + return await decompress_file(file_path) + except Exception as e: + raise ToolError(str(e)) from e diff --git a/clio-kit-mcp-servers/compression/src/compression_mcp/server.py b/clio-kit-mcp-servers/compression/src/compression_mcp/server.py new file mode 100644 index 00000000..350bdea1 --- /dev/null +++ b/clio-kit-mcp-servers/compression/src/compression_mcp/server.py @@ -0,0 +1,108 @@ +#!/usr/bin/env python3 +"""Compression MCP Server — gzip file compression and decompression.""" + +import logging +import os +from typing import Annotated + +from fastmcp import FastMCP +from fastmcp.prompts import Message +from pydantic import Field + +from . import mcp_handlers + +logging.basicConfig( + level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" +) +logger = logging.getLogger(__name__) + +mcp: FastMCP = FastMCP( + "compression", + instructions=( + "Provides gzip file compression and decompression. " + "Use compress_file to reduce file size, decompress_file to restore originals." + ), +) + + +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"compression", "file-io"}, +) +async def compress_file_tool( + file_path: Annotated[ + str, Field(description="Absolute path to the file to compress") + ], +) -> dict: + """Compress a file using gzip. Returns original/compressed sizes and compression ratio.""" + logger.info(f"Compressing file: {file_path}") + return await mcp_handlers.compress_file_handler(file_path) + + +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"decompression", "file-io"}, +) +async def decompress_file_tool( + file_path: Annotated[ + str, Field(description="Absolute path to the .gz file to decompress") + ], +) -> dict: + """Decompress a gzip-compressed (.gz) file back to its original form.""" + logger.info(f"Decompressing file: {file_path}") + return await mcp_handlers.decompress_file_handler(file_path) + + +@mcp.resource("compression://capabilities") +def compression_capabilities() -> dict: + """Supported compression formats and their capabilities.""" + return { + "formats": { + "gzip": { + "extension": ".gz", + "mime_type": "application/gzip", + "description": "GNU zip compression", + "operations": ["compress", "decompress"], + } + }, + "max_file_size": "No limit (streaming)", + } + + +@mcp.prompt() +def compress_workflow(file_path: str) -> list[Message]: + """Guided workflow for compressing a file and verifying the result.""" + return [ + Message( + f"I need to compress the file at {file_path}. " + "Please compress it, then verify the output exists and report the compression ratio." + ), + ] + + +def main() -> None: + """Main entry point for the compression MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Compression MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/compression/src/mcp_handlers.py b/clio-kit-mcp-servers/compression/src/mcp_handlers.py deleted file mode 100644 index 7724d7ef..00000000 --- a/clio-kit-mcp-servers/compression/src/mcp_handlers.py +++ /dev/null @@ -1,30 +0,0 @@ -""" -MCP handlers for compression capabilities. -These handlers wrap the compression capabilities for MCP protocol compliance. -""" - -import json -from typing import Dict, Any -from capabilities.compression_base import compress_file - - -async def compress_file_handler(file_path: str) -> Dict[str, Any]: - """ - Handler wrapping the file compression capability for MCP. - Returns compression results or an error payload on failure. - - Args: - file_path: Path to the file to compress - - Returns: - MCP-compliant response dictionary - """ - try: - result = await compress_file(file_path) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "compress_file", "error": type(e).__name__}, - "isError": True, - } diff --git a/clio-kit-mcp-servers/compression/src/server.py b/clio-kit-mcp-servers/compression/src/server.py deleted file mode 100644 index 02b9d2b3..00000000 --- a/clio-kit-mcp-servers/compression/src/server.py +++ /dev/null @@ -1,80 +0,0 @@ -#!/usr/bin/env python3 -""" -Compression MCP Server implementation using Model Context Protocol. -Provides file compression capabilities through MCP tools. -""" - -import os -import sys -import json -from fastmcp import FastMCP -from dotenv import load_dotenv -import logging -import mcp_handlers - -# Configure logging -logging.basicConfig( - level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" -) -logger = logging.getLogger(__name__) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Load environment variables -load_dotenv() - - -# Initialize MCP server -mcp: FastMCP = FastMCP("CompressionMCP") - - -@mcp.tool(name="compress_file", description="Compress a file using gzip compression.") -async def compress_file_tool(file_path: str) -> dict: - """ - Compress a file using gzip compression with detailed statistics and performance analytics. Supports all file types with comprehensive error handling. - - Args: - file_path (str): Absolute path to the file to compress - - Returns: - dict: Dictionary containing compression results with detailed statistics including original size, compressed size, compression ratio, and output file path. - """ - logger.info(f"Compressing file: {file_path}") - return await mcp_handlers.compress_file_handler(file_path) - - -def main(): - """ - Main entry point for the Compression MCP server. - Supports both stdio and SSE transports based on environment variables. - """ - try: - logger.info("Starting Compression MCP Server") - - # Determine which transport to use - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - if transport == "sse": - # SSE transport for web-based clients - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # Default stdio transport - logger.info("Starting stdio transport") - print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") - - except Exception as e: - logger.error(f"Server error: {e}") - print(json.dumps({"error": str(e)}), file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/compression/tests/test_compression_handler.py b/clio-kit-mcp-servers/compression/tests/test_compression_handler.py index 841193ec..fb1b507c 100644 --- a/clio-kit-mcp-servers/compression/tests/test_compression_handler.py +++ b/clio-kit-mcp-servers/compression/tests/test_compression_handler.py @@ -1,7 +1,7 @@ import pytest import os import tempfile -from capabilities.compression_base import compress_file +from compression_mcp.capabilities.compression_base import compress_file, decompress_file @pytest.fixture @@ -10,7 +10,8 @@ def sample_file(): with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: f.write("test content\n" * 100) yield f.name - os.unlink(f.name) + if os.path.exists(f.name): + os.unlink(f.name) # test successful compression of a file @@ -18,18 +19,19 @@ def sample_file(): async def test_compress_success(sample_file): result = await compress_file(sample_file) assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert os.path.exists(result["_meta"]["compressed_file"]) - os.unlink(result["_meta"]["compressed_file"]) + assert result["original_file"] == sample_file + assert result["original_size"] > 0 + assert result["compressed_size"] > 0 + assert result["compression_ratio"] >= 0 + assert os.path.exists(result["compressed_file"]) + os.unlink(result["compressed_file"]) # test compression of non-existent file @pytest.mark.asyncio async def test_compress_nonexistent_file(): - with pytest.raises(Exception) as exc_info: + with pytest.raises(FileNotFoundError, match="File not found"): await compress_file("nonexistent_file.txt") - assert "File not found" in str(exc_info.value) # test compression of empty file @@ -40,11 +42,10 @@ async def test_compress_empty_file(): try: result = await compress_file(f.name) assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - # Empty file should still compress successfully - assert os.path.exists(result["_meta"]["compressed_file"]) - os.unlink(result["_meta"]["compressed_file"]) + assert result["original_size"] == 0 + assert result["compression_ratio"] == 0.0 + assert os.path.exists(result["compressed_file"]) + os.unlink(result["compressed_file"]) finally: os.unlink(f.name) @@ -52,7 +53,7 @@ async def test_compress_empty_file(): # test compression with permission error @pytest.mark.asyncio async def test_compress_permission_error(): - """Test that PermissionError is properly caught and raised""" + """Test that PermissionError is properly raised.""" import unittest.mock as mock with mock.patch("os.path.exists", return_value=True): @@ -60,21 +61,49 @@ async def test_compress_permission_error(): with mock.patch( "builtins.open", side_effect=PermissionError("Permission denied") ): - with pytest.raises(Exception) as exc_info: + with pytest.raises(PermissionError, match="Permission denied"): await compress_file("/some/file.txt") - assert "Permission denied" in str(exc_info.value) # test compression with generic exception @pytest.mark.asyncio async def test_compress_generic_exception(): - """Test that generic exceptions are properly caught and raised""" + """Test that generic exceptions are properly raised.""" import unittest.mock as mock with mock.patch("os.path.exists", return_value=True): with mock.patch("os.path.getsize", side_effect=RuntimeError("Disk error")): - with pytest.raises(Exception) as exc_info: + with pytest.raises(RuntimeError, match="Disk error"): await compress_file("/some/file.txt") - assert "Compression failed" in str(exc_info.value) or "Disk error" in str( - exc_info.value - ) + + +# --- DECOMPRESSION TESTS --- + + +@pytest.mark.asyncio +async def test_decompress_success(sample_file): + """Test successful compress then decompress round-trip.""" + result = await compress_file(sample_file) + gz_path = result["compressed_file"] + + decomp_result = await decompress_file(gz_path) + assert isinstance(decomp_result, dict) + assert decomp_result["compressed_file"] == gz_path + assert decomp_result["decompressed_size"] > 0 + assert os.path.exists(decomp_result["decompressed_file"]) + os.unlink(decomp_result["decompressed_file"]) + os.unlink(gz_path) + + +@pytest.mark.asyncio +async def test_decompress_nonexistent_file(): + """Test decompression of non-existent file.""" + with pytest.raises(FileNotFoundError, match="File not found"): + await decompress_file("nonexistent_file.gz") + + +@pytest.mark.asyncio +async def test_decompress_non_gz_file(sample_file): + """Test decompression of a file without .gz extension.""" + with pytest.raises(ValueError, match="Not a gzip file"): + await decompress_file(sample_file) diff --git a/clio-kit-mcp-servers/compression/tests/test_integration.py b/clio-kit-mcp-servers/compression/tests/test_integration.py index 0bb6bc14..00cd1ec8 100644 --- a/clio-kit-mcp-servers/compression/tests/test_integration.py +++ b/clio-kit-mcp-servers/compression/tests/test_integration.py @@ -1,10 +1,8 @@ import pytest import os import tempfile -import sys -sys.path.append(os.path.join(os.path.dirname(__file__), "..", "src")) -from server import mcp +from compression_mcp.server import mcp @pytest.fixture @@ -21,20 +19,16 @@ def sample_file(): @pytest.mark.asyncio async def test_compress_file_tool(sample_file): - """Test the MCP tool integration through the handler""" - from mcp_handlers import compress_file_handler + """Test the MCP tool integration through the handler.""" + from compression_mcp.mcp_handlers import compress_file_handler - # Call the handler directly (which is what the MCP tool would call) result = await compress_file_handler(sample_file) assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert os.path.exists(result["_meta"]["compressed_file"]) + assert result["original_file"] == sample_file + assert os.path.exists(result["compressed_file"]) def test_mcp_server_initialization(): - """Test that the MCP server initializes correctly""" - assert mcp.name == "CompressionMCP" - # Test that the server object exists and has the correct name - # We can't easily access internal FastMCP structure, so just verify basic properties + """Test that the MCP server initializes correctly.""" + assert mcp.name == "compression" diff --git a/clio-kit-mcp-servers/compression/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/compression/tests/test_mcp_handlers.py index 7546f972..49f50490 100644 --- a/clio-kit-mcp-servers/compression/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/compression/tests/test_mcp_handlers.py @@ -1,10 +1,9 @@ import pytest import os import tempfile -import sys -sys.path.append(os.path.join(os.path.dirname(__file__), "..", "src")) -from mcp_handlers import compress_file_handler +from fastmcp.exceptions import ToolError +from compression_mcp.mcp_handlers import compress_file_handler @pytest.fixture @@ -18,22 +17,17 @@ def sample_file(): @pytest.mark.asyncio async def test_compress_file_handler_success(sample_file): - """Test successful compression through MCP handler""" + """Test successful compression through MCP handler.""" result = await compress_file_handler(sample_file) assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert "compressed successfully" in result["content"][0]["text"] - assert os.path.exists(result["_meta"]["compressed_file"]) - os.unlink(result["_meta"]["compressed_file"]) + assert result["original_file"] == sample_file + assert result["compressed_size"] > 0 + assert os.path.exists(result["compressed_file"]) + os.unlink(result["compressed_file"]) @pytest.mark.asyncio async def test_compress_file_handler_error(): - """Test error handling in MCP handler""" - result = await compress_file_handler("nonexistent_file.txt") - assert isinstance(result, dict) - assert result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert "error" in result["_meta"] - assert "File not found" in result["content"][0]["text"] + """Test error handling in MCP handler raises ToolError.""" + with pytest.raises(ToolError, match="File not found"): + await compress_file_handler("nonexistent_file.txt") diff --git a/clio-kit-mcp-servers/compression/tests/test_server_basic.py b/clio-kit-mcp-servers/compression/tests/test_server_basic.py index 6e19c8d1..f653233d 100644 --- a/clio-kit-mcp-servers/compression/tests/test_server_basic.py +++ b/clio-kit-mcp-servers/compression/tests/test_server_basic.py @@ -1,17 +1,14 @@ import pytest import os import tempfile -import sys - -sys.path.append(os.path.join(os.path.dirname(__file__), "..", "src")) from unittest.mock import patch -# Test the compress_file_tool function directly without server dependency +from fastmcp.exceptions import ToolError @pytest.fixture def sample_file(): - """Create a temporary file with test content""" + """Create a temporary file with test content.""" with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: f.write("test content for server testing\n" * 50) yield f.name @@ -23,23 +20,19 @@ def sample_file(): @pytest.mark.asyncio async def test_compress_file_handler_direct(): - """Test the compress_file_handler function directly""" - import mcp_handlers + """Test the compress_file_handler function directly.""" + from compression_mcp import mcp_handlers - # Test with a temporary file with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: f.write("test content\n" * 100) try: result = await mcp_handlers.compress_file_handler(f.name) assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert os.path.exists(result["_meta"]["compressed_file"]) - - # Clean up compressed file - if os.path.exists(result["_meta"]["compressed_file"]): - os.unlink(result["_meta"]["compressed_file"]) + assert result["original_file"] == f.name + assert os.path.exists(result["compressed_file"]) + if os.path.exists(result["compressed_file"]): + os.unlink(result["compressed_file"]) finally: if os.path.exists(f.name): os.unlink(f.name) @@ -47,29 +40,25 @@ async def test_compress_file_handler_direct(): @pytest.mark.asyncio async def test_compress_file_handler_error_direct(): - """Test the compress_file_handler error handling directly""" - import mcp_handlers - - result = await mcp_handlers.compress_file_handler("nonexistent_file.txt") + """Test the compress_file_handler raises ToolError on missing file.""" + from compression_mcp import mcp_handlers - assert isinstance(result, dict) - assert result["isError"] - assert result["_meta"]["tool"] == "compress_file" - assert "error" in result["_meta"] + with pytest.raises(ToolError, match="File not found"): + await mcp_handlers.compress_file_handler("nonexistent_file.txt") def test_server_module_imports(): - """Test that server module can be analyzed without running it""" + """Test that server module can be analyzed without running it.""" import ast - server_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") + server_path = os.path.join( + os.path.dirname(__file__), "..", "src", "compression_mcp", "server.py" + ) with open(server_path, "r") as f: content = f.read() - # Parse the AST to check structure tree = ast.parse(content) - # Check for main function main_found = False compress_tool_found = False @@ -77,8 +66,6 @@ def test_server_module_imports(): if isinstance(node, ast.FunctionDef): if node.name == "main": main_found = True - elif node.name == "compress_file_tool": - compress_tool_found = True elif isinstance(node, ast.AsyncFunctionDef): if node.name == "compress_file_tool": compress_tool_found = True @@ -88,87 +75,57 @@ def test_server_module_imports(): def test_server_environment_handling(): - """Test environment variable handling logic without running server""" - # Test the logic that would be in main() function - - # Test default transport + """Test environment variable handling logic without running server.""" transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - assert transport == "stdio" # Should default to stdio + assert transport == "stdio" - # Test with environment variable set - with patch.dict(os.environ, {"MCP_TRANSPORT": "sse"}): + with patch.dict(os.environ, {"MCP_TRANSPORT": "http"}): transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - assert transport == "sse" - - # Test SSE host/port defaults - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - assert host == "0.0.0.0" - assert port == 8000 - - # Test with custom values - with patch.dict(os.environ, {"MCP_SSE_HOST": "localhost", "MCP_SSE_PORT": "9000"}): - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - assert host == "localhost" - assert port == 9000 + assert transport == "http" @pytest.mark.asyncio async def test_end_to_end_compression_workflow(sample_file): - """Test the complete compression workflow""" - import mcp_handlers + """Test the complete compression workflow.""" + from compression_mcp import mcp_handlers - # Test the complete workflow result = await mcp_handlers.compress_file_handler(sample_file) - # Verify all expected fields are present - assert "content" in result - assert "_meta" in result - assert "isError" in result - - # Verify metadata structure - meta = result["_meta"] - assert "tool" in meta - assert "original_file" in meta - assert "compressed_file" in meta - assert "original_size" in meta - assert "compressed_size" in meta - assert "compression_ratio" in meta + assert "original_file" in result + assert "compressed_file" in result + assert "original_size" in result + assert "compressed_size" in result + assert "compression_ratio" in result + assert "message" in result - # Verify compression actually happened - assert meta["original_size"] > 0 - assert meta["compressed_size"] > 0 - assert meta["compression_ratio"] >= 0 + assert result["original_size"] > 0 + assert result["compressed_size"] > 0 + assert result["compression_ratio"] >= 0 - # Verify files exist - assert os.path.exists(meta["original_file"]) - assert os.path.exists(meta["compressed_file"]) + assert os.path.exists(result["original_file"]) + assert os.path.exists(result["compressed_file"]) - # Clean up - if os.path.exists(meta["compressed_file"]): - os.unlink(meta["compressed_file"]) + if os.path.exists(result["compressed_file"]): + os.unlink(result["compressed_file"]) def test_logging_configuration(): - """Test that logging can be configured properly""" + """Test that logging can be configured properly.""" import logging - # Test basic logging setup - logger = logging.getLogger("test_compression") - logger.setLevel(logging.INFO) + test_logger = logging.getLogger("test_compression") + test_logger.setLevel(logging.INFO) - # Should not raise any errors - logger.info("Test message") - logger.error("Test error") + test_logger.info("Test message") + test_logger.error("Test error") - assert logger.level == logging.INFO + assert test_logger.level == logging.INFO @pytest.mark.asyncio async def test_compression_with_different_file_sizes(): - """Test compression with various file sizes""" - import mcp_handlers + """Test compression with various file sizes.""" + from compression_mcp import mcp_handlers # Test small file with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: @@ -176,32 +133,23 @@ async def test_compression_with_different_file_sizes(): try: result = await mcp_handlers.compress_file_handler(f.name) - assert not result["isError"] - # Verify compression ratio is calculated - - # Clean up - if os.path.exists(result["_meta"]["compressed_file"]): - os.unlink(result["_meta"]["compressed_file"]) + assert result["compression_ratio"] is not None + if os.path.exists(result["compressed_file"]): + os.unlink(result["compressed_file"]) finally: if os.path.exists(f.name): os.unlink(f.name) - # Test larger file with repetitive content (should compress better) + # Test larger file with repetitive content with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: for i in range(1000): f.write("This is repetitive content that should compress well.\n") try: result = await mcp_handlers.compress_file_handler(f.name) - assert not result["isError"] - large_ratio = result["_meta"]["compression_ratio"] - - # Larger file with repetitive content should compress better - assert large_ratio > 0 - - # Clean up - if os.path.exists(result["_meta"]["compressed_file"]): - os.unlink(result["_meta"]["compressed_file"]) + assert result["compression_ratio"] > 0 + if os.path.exists(result["compressed_file"]): + os.unlink(result["compressed_file"]) finally: if os.path.exists(f.name): os.unlink(f.name) diff --git a/clio-kit-mcp-servers/compression/tests/test_server_coverage_completion.py b/clio-kit-mcp-servers/compression/tests/test_server_coverage_completion.py index 3980831c..cc867b6a 100644 --- a/clio-kit-mcp-servers/compression/tests/test_server_coverage_completion.py +++ b/clio-kit-mcp-servers/compression/tests/test_server_coverage_completion.py @@ -1,15 +1,14 @@ import pytest import os import tempfile -import sys -from unittest.mock import patch, MagicMock +from unittest.mock import patch -sys.path.append(os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError @pytest.fixture def sample_file(): - """Create a temporary file with test content""" + """Create a temporary file with test content.""" with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: f.write("test content for coverage completion\n" * 50) yield f.name @@ -21,141 +20,71 @@ def sample_file(): @pytest.mark.asyncio async def test_compress_file_tool_actual_execution(sample_file): - """Test the actual execution of compress_file_tool to cover lines 43-44""" - # Use real implementation but mock the FastMCP dependencies - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("server.logger") as mock_logger: - # Import the module to initialize it - import server + """Test the actual execution of compress_file_tool.""" + from compression_mcp import mcp_handlers - # Now we need to replace the compress_file_tool with the actual function - # but without the decorator interference - async def real_compress_file_tool(file_path: str): - """Real implementation for testing""" - # This covers line 43 - server.logger.info(f"Compressing file: {file_path}") + result = await mcp_handlers.compress_file_handler(sample_file) - # This covers line 44 - import mcp_handlers + assert isinstance(result, dict) + assert result["original_file"] == sample_file + assert result["compressed_size"] > 0 - return await mcp_handlers.compress_file_handler(file_path) - - # Test the real function - result = await real_compress_file_tool(sample_file) - - # Verify line 43 was executed (logging call) - mock_logger.info.assert_called_with(f"Compressing file: {sample_file}") - - # Verify line 44 was executed (successful compression) - assert isinstance(result, dict) - assert not result["isError"] - assert result["_meta"]["tool"] == "compress_file" - - # Clean up - if os.path.exists(result["_meta"]["compressed_file"]): - os.unlink(result["_meta"]["compressed_file"]) + if os.path.exists(result["compressed_file"]): + os.unlink(result["compressed_file"]) @pytest.mark.asyncio async def test_compress_file_tool_error_execution(): - """Test compress_file_tool with error to cover lines 43-44 in error case""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("server.logger") as mock_logger: - import server - - # Real function implementation for error testing - async def real_compress_file_tool(file_path: str): - """Real implementation for error testing""" - # This covers line 43 - server.logger.info(f"Compressing file: {file_path}") - - # This covers line 44 - import mcp_handlers - - return await mcp_handlers.compress_file_handler(file_path) + """Test compress_file_tool raises ToolError on missing file.""" + from compression_mcp import mcp_handlers - # Test with non-existent file - result = await real_compress_file_tool("nonexistent_file.txt") - - # Verify line 43 was executed - mock_logger.info.assert_called_with( - "Compressing file: nonexistent_file.txt" - ) - - # Verify line 44 was executed (error case) - assert result["isError"] - assert result["_meta"]["tool"] == "compress_file" + with pytest.raises(ToolError, match="File not found"): + await mcp_handlers.compress_file_handler("nonexistent_file.txt") def test_main_script_execution_coverage(): - """Test the if __name__ == '__main__' block execution to cover line 80""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger"): - # Import the server module - import server - - # Mock the main function to avoid actual server startup - with patch.object(server, "main") as mock_main: - # Simulate the if __name__ == "__main__" execution - # This covers line 80 - server.main() + """Test the if __name__ == '__main__' block execution.""" + from compression_mcp import server - # Verify main was called (line 80 coverage) - mock_main.assert_called() + with patch.object(server, "main") as mock_main: + server.main() + mock_main.assert_called() def test_server_initialization_with_real_imports(): - """Test server initialization to ensure import lines are covered""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig") as mock_basic_config: - with patch("logging.getLogger") as mock_get_logger: - # Force module reload to ensure import coverage - if "server" in sys.modules: - del sys.modules["server"] + """Test server initialization to ensure import lines are covered.""" + from compression_mcp import server - # Import server module - this should cover all import lines - import server # noqa: F401 - - # Verify all the setup was called - mock_basic_config.assert_called() - mock_get_logger.assert_called() + assert hasattr(server, "mcp") + assert hasattr(server, "logger") + assert hasattr(server, "main") def test_logger_usage_in_server(): - """Test that the logger is properly used in server functions""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("server.logger") as mock_logger: - import server - - # Verify the logger is available - assert hasattr(server, "logger") + """Test that the logger is properly used in server functions.""" + from compression_mcp import server - # Test that logger methods are callable - server.logger.info("Test message") - mock_logger.info.assert_called_with("Test message") + with patch.object(server, "logger") as mock_logger: + assert hasattr(server, "logger") + server.logger.info("Test message") + mock_logger.info.assert_called_with("Test message") def test_decorator_pattern_coverage(): - """Test that the decorator pattern is properly analyzed""" + """Test that the decorator pattern is properly analyzed.""" import ast - # Read the server source to verify decorator coverage - server_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") + server_path = os.path.join( + os.path.dirname(__file__), "..", "src", "compression_mcp", "server.py" + ) with open(server_path, "r") as f: content = f.read() - # Verify the decorator exists assert "@mcp.tool(" in content assert "compress_file_tool" in content - # Parse AST to verify structure tree = ast.parse(content) - # Find decorated function found_decorated_function = False for node in ast.walk(tree): if isinstance(node, ast.AsyncFunctionDef) and node.name == "compress_file_tool": @@ -167,16 +96,9 @@ def test_decorator_pattern_coverage(): def test_mcp_handlers_import_coverage(): - """Test that mcp_handlers import is properly covered""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger"): - # Import server which should import mcp_handlers - import server - - # Verify mcp_handlers is accessible - assert hasattr(server, "mcp_handlers") - - # Verify the handler function exists - assert hasattr(server.mcp_handlers, "compress_file_handler") - assert callable(server.mcp_handlers.compress_file_handler) + """Test that mcp_handlers import is properly covered.""" + from compression_mcp import server + + assert hasattr(server, "mcp_handlers") + assert hasattr(server.mcp_handlers, "compress_file_handler") + assert callable(server.mcp_handlers.compress_file_handler) diff --git a/clio-kit-mcp-servers/compression/tests/test_server_execution_simple.py b/clio-kit-mcp-servers/compression/tests/test_server_execution_simple.py index 24332c74..040ab604 100644 --- a/clio-kit-mcp-servers/compression/tests/test_server_execution_simple.py +++ b/clio-kit-mcp-servers/compression/tests/test_server_execution_simple.py @@ -1,15 +1,12 @@ import pytest import os import tempfile -import sys from unittest.mock import patch, MagicMock -sys.path.append(os.path.join(os.path.dirname(__file__), "..", "src")) - @pytest.fixture def sample_file(): - """Create a temporary file with test content""" + """Create a temporary file with test content.""" with tempfile.NamedTemporaryFile(mode="w", delete=False) as f: f.write("test content for server execution testing\n" * 50) yield f.name @@ -20,24 +17,21 @@ def sample_file(): def test_compress_file_tool_definition_in_source(): - """Test that compress_file_tool is properly defined in source code""" + """Test that compress_file_tool is properly defined in source code.""" import ast - # Read server.py source directly to test the function definition - server_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") + server_path = os.path.join( + os.path.dirname(__file__), "..", "src", "compression_mcp", "server.py" + ) with open(server_path, "r") as f: source = f.read() - # Parse AST to verify function exists and is async tree = ast.parse(source) compress_function_found = False for node in ast.walk(tree): if isinstance(node, ast.AsyncFunctionDef) and node.name == "compress_file_tool": compress_function_found = True - # Verify it has the expected parameters - assert len(node.args.args) == 1 # file_path parameter - assert node.args.args[0].arg == "file_path" break assert compress_function_found, ( @@ -46,239 +40,93 @@ def test_compress_file_tool_definition_in_source(): def test_main_function_execution_stdio(): - """Test main function execution with stdio transport""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger") as mock_get_logger: - mock_logger = MagicMock() - mock_get_logger.return_value = mock_logger - - # Mock the mcp object that would be created - mock_mcp_instance = MagicMock() - - with patch("server.mcp", mock_mcp_instance): - with patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}): - with patch("builtins.print") as mock_print: - with patch("server.logger") as mock_server_logger: - import server # noqa: F401 - - # Execute main - this will test the actual function execution - try: - server.main() - except SystemExit: - pass # Expected behavior - - # Verify the key logging calls were made - expected_calls = [ - "Starting Compression MCP Server", - "Starting stdio transport", - ] - for call_msg in expected_calls: - mock_server_logger.info.assert_any_call(call_msg) - - # Verify print was called for stderr output - mock_print.assert_called() - - # Verify mcp.run was called - mock_mcp_instance.run.assert_called_with(transport="stdio") - - -def test_main_function_execution_sse(): - """Test main function execution with SSE transport""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger") as mock_get_logger: - mock_logger = MagicMock() - mock_get_logger.return_value = mock_logger - - mock_mcp_instance = MagicMock() - - with patch("server.mcp", mock_mcp_instance): - with patch.dict( - os.environ, - { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "localhost", - "MCP_SSE_PORT": "9000", - }, - ): - with patch("builtins.print") as mock_print: - with patch("server.logger") as mock_server_logger: - import server # noqa: F401 - - try: - server.main() - except SystemExit: - pass - - # Verify logging calls - mock_server_logger.info.assert_any_call( - "Starting Compression MCP Server" - ) - mock_server_logger.info.assert_any_call( - "Starting SSE transport on localhost:9000" - ) - - # Verify print was called - mock_print.assert_called() - - # Verify mcp.run was called with SSE parameters - mock_mcp_instance.run.assert_called_with( - transport="sse", host="localhost", port=9000 - ) - - -def test_main_function_exception_handling(): - """Test main function exception handling path""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger") as mock_get_logger: - mock_logger = MagicMock() - mock_get_logger.return_value = mock_logger - - # Mock mcp.run to raise an exception - mock_mcp_instance = MagicMock() - mock_mcp_instance.run.side_effect = Exception("Test server error") - - with patch("server.mcp", mock_mcp_instance): - with patch("builtins.print") as mock_print: - with patch("sys.exit") as mock_exit: - with patch("server.logger") as mock_server_logger: - import server # noqa: F401 - - # Execute main - should catch exception - server.main() - - # Verify error logging - mock_server_logger.error.assert_called_with( - "Server error: Test server error" - ) - - # Verify error output to stderr - mock_print.assert_called() - - # Verify sys.exit(1) was called - mock_exit.assert_called_with(1) + """Test main function execution with stdio transport.""" + from compression_mcp import server + mock_mcp_instance = MagicMock() -def test_module_imports_and_setup(): - """Test module-level imports and setup code execution""" - with patch("logging.basicConfig") as mock_basic_config: - with patch("logging.getLogger") as mock_get_logger: - mock_logger = MagicMock() - mock_get_logger.return_value = mock_logger - - with patch.dict( - "sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()} - ): - # Force reimport to trigger module-level code - if "server" in sys.modules: - del sys.modules["server"] - - # Import should trigger all module-level setup - import server # noqa: F401 - - # Verify logging was configured - mock_basic_config.assert_called_once_with( - level=20, # logging.INFO - format="%(asctime)s - %(levelname)s - %(message)s", + with patch.object(server, "mcp", mock_mcp_instance): + with patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}): + with patch("argparse.ArgumentParser.parse_args") as mock_parse: + mock_parse.return_value = MagicMock( + transport=None, host="0.0.0.0", port=8000 ) + server.main() - # Verify logger was obtained - mock_get_logger.assert_called() + mock_mcp_instance.run.assert_called_with(transport="stdio") -def test_environment_variable_handling(): - """Test various environment variable combinations""" - with patch.dict("sys.modules", {"fastmcp": MagicMock(), "dotenv": MagicMock()}): - with patch("logging.basicConfig"): - with patch("logging.getLogger") as mock_get_logger: - mock_logger = MagicMock() - mock_get_logger.return_value = mock_logger +def test_main_function_execution_http(): + """Test main function execution with http transport.""" + from compression_mcp import server - mock_mcp_instance = MagicMock() + mock_mcp_instance = MagicMock() - with patch("server.mcp", mock_mcp_instance): - # Test default values (no env vars set) - with patch.dict(os.environ, {}, clear=True): - with patch("builtins.print"): - import server # noqa: F401 + with patch.object(server, "mcp", mock_mcp_instance): + with patch("argparse.ArgumentParser.parse_args") as mock_parse: + mock_parse.return_value = MagicMock( + transport="http", host="localhost", port=9000 + ) + server.main() - try: - server.main() - except SystemExit: - pass + mock_mcp_instance.run.assert_called_with( + transport="http", host="localhost", port=9000 + ) - # Should default to stdio - mock_mcp_instance.run.assert_called_with(transport="stdio") +def test_module_imports_and_setup(): + """Test module-level imports and setup code execution.""" + from compression_mcp import server -def test_fastmcp_initialization(): - """Test FastMCP server initialization""" - mock_fastmcp_class = MagicMock() - mock_fastmcp_instance = MagicMock() - mock_fastmcp_class.return_value = mock_fastmcp_instance + assert hasattr(server, "mcp") + assert hasattr(server, "logger") + assert hasattr(server, "mcp_handlers") + assert hasattr(server, "main") + assert hasattr(server, "compress_file_tool") + assert hasattr(server, "decompress_file_tool") - with patch.dict( - "sys.modules", - {"fastmcp": MagicMock(FastMCP=mock_fastmcp_class), "dotenv": MagicMock()}, - ): - with patch("logging.basicConfig"): - with patch("logging.getLogger"): - # Clear module to force fresh import - if "server" in sys.modules: - del sys.modules["server"] - # Import should create FastMCP instance - import server # noqa: F401 +def test_environment_variable_handling(): + """Test various environment variable combinations.""" + from compression_mcp import server - # Verify FastMCP was instantiated with correct name - mock_fastmcp_class.assert_called_with("CompressionMCP") + mock_mcp_instance = MagicMock() + with patch.object(server, "mcp", mock_mcp_instance): + with patch.dict(os.environ, {}, clear=True): + with patch("argparse.ArgumentParser.parse_args") as mock_parse: + mock_parse.return_value = MagicMock( + transport=None, host="0.0.0.0", port=8000 + ) + server.main() -def test_dotenv_loading(): - """Test that dotenv.load_dotenv is called during module import""" - mock_dotenv_module = MagicMock() + mock_mcp_instance.run.assert_called_with(transport="stdio") - with patch.dict( - "sys.modules", {"fastmcp": MagicMock(), "dotenv": mock_dotenv_module} - ): - with patch("logging.basicConfig"): - with patch("logging.getLogger"): - # Clear module to force fresh import - if "server" in sys.modules: - del sys.modules["server"] - # Import should call load_dotenv - import server # noqa: F401 +def test_fastmcp_initialization(): + """Test FastMCP server initialization.""" + from compression_mcp import server - # Verify load_dotenv was called - mock_dotenv_module.load_dotenv.assert_called_once() + assert server.mcp.name == "compression" def test_tool_decorator_presence(): - """Test that the compress_file_tool function has the expected decorator pattern""" + """Test that the compress_file_tool function has the expected decorator pattern.""" import ast - # Read the server.py source directly - server_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") + server_path = os.path.join( + os.path.dirname(__file__), "..", "src", "compression_mcp", "server.py" + ) with open(server_path, "r") as f: source = f.read() - # Parse the AST to find the decorator tree = ast.parse(source) - # Find the compress_file_tool function and check for decorator for node in ast.walk(tree): if isinstance(node, ast.AsyncFunctionDef) and node.name == "compress_file_tool": - # Should have at least one decorator assert len(node.decorator_list) > 0 - - # The decorator should be a call to mcp.tool decorator = node.decorator_list[0] assert isinstance(decorator, ast.Call) - - # Verify this covers the @mcp.tool line break else: assert False, "compress_file_tool function not found" diff --git a/clio-kit-mcp-servers/compression/uv.lock b/clio-kit-mcp-servers/compression/uv.lock index 7289242c..126564b9 100644 --- a/clio-kit-mcp-servers/compression/uv.lock +++ b/clio-kit-mcp-servers/compression/uv.lock @@ -279,7 +279,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "python-dotenv", specifier = ">=1.0.0" }, ] @@ -445,18 +445,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.2" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/cc/2e/8c45ef5b00bd48d7cabbf6f90b7f12df4c232755cd46e6dbc6690f9ac0c5/cyclopts-3.22.2.tar.gz", hash = "sha256:d3495231af6ae86479579777d212ddf77b113200f828badeaf401162ed87227d", size = 74520, upload-time = "2025-07-09T12:21:46.866Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/5b/5939e05d87def1612c494429bee705d6b852fad1d21dd2dee1e3ce39997e/cyclopts-3.22.2-py3-none-any.whl", hash = "sha256:6681b0815fa2de2bccc364468fd25b15aa9617cb505c0b16ca62e2b18a57619e", size = 84578, upload-time = "2025-07-09T12:21:44.878Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -522,27 +523,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -666,6 +673,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.0" @@ -740,7 +756,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -754,11 +770,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -845,6 +863,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "24.2" @@ -901,15 +932,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -924,19 +955,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -1558,14 +1576,14 @@ wheels = [ [[package]] name = "typing-inspection" -version = "0.4.0" +version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/82/5c/e6082df02e215b846b4b8c0b887a64d7d08ffaba30605502639d44c06b82/typing_inspection-0.4.0.tar.gz", hash = "sha256:9765c87de36671694a67904bf2c96e395be9c6439bb6c87b5142569dcdd65122", size = 76222, upload-time = "2025-02-25T17:27:59.638Z" } +sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/31/08/aa4fdfb71f7de5176385bd9e90852eaf6b5d622735020ad600f2bab54385/typing_inspection-0.4.0-py3-none-any.whl", hash = "sha256:50e72559fcd2a6367a19f7a7e610e6afcb9fac940c650290eed893d61386832f", size = 14125, upload-time = "2025-02-25T17:27:57.754Z" }, + { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" }, ] [[package]] @@ -1579,16 +1597,119 @@ wheels = [ [[package]] name = "uvicorn" -version = "0.34.1" +version = "0.41.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "click" }, { name = "h11" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/86/37/dd92f1f9cedb5eaf74d9999044306e06abe65344ff197864175dbbd91871/uvicorn-0.34.1.tar.gz", hash = "sha256:af981725fc4b7ffc5cb3b0e9eda6258a90c4b52cb2a83ce567ae0a7ae1757afc", size = 76755, upload-time = "2025-04-13T13:48:04.305Z" } +sdist = { url = "https://files.pythonhosted.org/packages/32/ce/eeb58ae4ac36fe09e3842eb02e0eb676bf2c53ae062b98f1b2531673efdd/uvicorn-0.41.0.tar.gz", hash = "sha256:09d11cf7008da33113824ee5a1c6422d89fbc2ff476540d69a34c87fab8b571a", size = 82633, upload-time = "2026-02-16T23:07:24.1Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5f/38/a5801450940a858c102a7ad9e6150146a25406a119851c993148d56ab041/uvicorn-0.34.1-py3-none-any.whl", hash = "sha256:984c3a8c7ca18ebaad15995ee7401179212c59521e67bfc390c07fa2b8d2e065", size = 62404, upload-time = "2025-04-13T13:48:02.408Z" }, + { url = "https://files.pythonhosted.org/packages/83/e4/d04a086285c20886c0daad0e026f250869201013d18f81d9ff5eada73a88/uvicorn-0.41.0-py3-none-any.whl", hash = "sha256:29e35b1d2c36a04b9e180d4007ede3bcb32a85fbdfd6c6aeb3f26839de088187", size = 68783, upload-time = "2026-02-16T23:07:22.357Z" }, +] + +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, ] [[package]] diff --git a/clio-kit-mcp-servers/darshan/.claude-plugin/plugin.json b/clio-kit-mcp-servers/darshan/.claude-plugin/plugin.json new file mode 100644 index 00000000..3907838f --- /dev/null +++ b/clio-kit-mcp-servers/darshan/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-darshan", + "description": "Darshan I/O profiler MCP server for analyzing I/O trace files", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/darshan/.mcp.json b/clio-kit-mcp-servers/darshan/.mcp.json new file mode 100644 index 00000000..5d566363 --- /dev/null +++ b/clio-kit-mcp-servers/darshan/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-darshan": { + "command": "uvx", + "args": [ + "clio-kit", + "darshan" + ] + } +} diff --git a/clio-kit-mcp-servers/darshan/README.md b/clio-kit-mcp-servers/darshan/README.md index 6a605b58..78a0a18d 100644 --- a/clio-kit-mcp-servers/darshan/README.md +++ b/clio-kit-mcp-servers/darshan/README.md @@ -142,89 +142,114 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\darshan run darshan- ## Capabilities ### `load_darshan_log` -**Description**: Load and parse a Darshan log file to extract metadata and basic I/O information. - -**Parameters**: -- `log_file_path` (str): Absolute path to the .darshan log file - -**Returns**: dict: Dictionary with job information, modules detected, and file count statistics. +**Description**: Load and parse a Darshan log file to extract I/O performance metrics and metadata. +**Hints**: read-only, idempotent +**Tags**: darshan, io-analysis ### `get_job_summary` -**Description**: Get comprehensive job-level summary including runtime statistics and I/O performance overview. - -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file - -**Returns**: dict: Dictionary with runtime metrics, process information, and I/O volume statistics. +**Description**: Get job-level summary from a Darshan log including runtime, process count, and I/O volume. +**Hints**: read-only, idempotent +**Tags**: darshan, io-analysis ### `analyze_file_access_patterns` -**Description**: Analyze file access patterns to understand application I/O behavior and optimization opportunities. - -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file -- `file_pattern` (str, optional): Filter files by pattern (e.g., '*.dat', '/scratch/*') - -**Returns**: dict: Dictionary with access pattern analysis including sequential vs random access statistics. +**Description**: Analyze file access patterns including read/write types and sequential vs random access. +**Hints**: read-only, idempotent +**Tags**: darshan, io-analysis ### `get_io_performance_metrics` -**Description**: Extract detailed I/O performance metrics including bandwidth, IOPS, and request size analysis. - -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file - -**Returns**: dict: Dictionary with comprehensive performance metrics and throughput analysis. +**Description**: Extract I/O performance metrics including bandwidth, IOPS, and request sizes. +**Hints**: read-only, idempotent +**Tags**: darshan, performance ### `analyze_posix_operations` -**Description**: Analyze POSIX system call patterns including open, read, write, and seek operations. +**Description**: Analyze POSIX I/O operations including read/write system calls and their frequency. +**Hints**: read-only, idempotent +**Tags**: darshan, io-analysis -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file +### `analyze_mpiio_operations` +**Description**: Analyze MPI-IO operations including collective vs independent operations. +**Hints**: read-only, idempotent +**Tags**: darshan, io-analysis -**Returns**: dict: Dictionary with POSIX operation statistics and system call analysis. +### `identify_io_bottlenecks` +**Description**: Identify I/O performance bottlenecks by analyzing access patterns and operations. +**Hints**: read-only, idempotent +**Tags**: darshan, performance -### `analyze_mpiio_operations` -**Description**: Analyze MPI-IO operations including collective vs independent I/O patterns and performance. +### `get_timeline_analysis` +**Description**: Generate timeline analysis showing I/O activity over time and temporal patterns. +**Hints**: read-only, idempotent +**Tags**: darshan, performance -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file +### `compare_darshan_logs` +**Description**: Compare two Darshan log files to identify performance differences between runs. +**Hints**: read-only, idempotent +**Tags**: darshan, performance -**Returns**: dict: Dictionary with MPI-IO operation analysis and collective I/O performance metrics. +### `generate_io_summary_report` +**Description**: Generate a comprehensive I/O summary report with findings and recommendations. +**Hints**: read-only, idempotent +**Tags**: darshan, performance -### `identify_io_bottlenecks` -**Description**: Automatically identify potential I/O performance bottlenecks and optimization opportunities. +### Resources -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file +- `darshan://capabilities` - Darshan I/O profiling analysis capabilities. -**Returns**: dict: Dictionary with identified performance issues and recommended optimizations. +### Prompts -### `get_timeline_analysis` -**Description**: Generate temporal analysis of I/O activity to understand performance patterns over time. +- **analyze_io_performance**: Guided workflow for analyzing I/O performance from a Darshan log. +## Claude Code -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file -- `time_resolution` (str): Time resolution for analysis (e.g., '1s', '100ms') +```bash +claude mcp add clio-darshan -- uvx clio-kit darshan +``` -**Returns**: dict: Dictionary with timeline analysis and temporal I/O patterns. +Or install via the CLIO Kit plugin marketplace: -### `compare_darshan_logs` -**Description**: Compare two Darshan log files to identify performance differences and optimization results. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-darshan@iowarp-clio-kit +``` +## Claude Desktop -**Parameters**: -- `log_file_1` (str): Path to the first log file -- `log_file_2` (str): Path to the second log file -- `comparison_metrics` (list): List of metrics to compare ['bandwidth', 'iops', 'file_count'] +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Returns**: dict: Dictionary with comparative analysis and performance delta identification. +```json +{ + "mcpServers": { + "clio-darshan": { + "command": "uvx", + "args": [ + "clio-kit", + "darshan" + ] + } + } +} +``` +## Gemini CLI -### `generate_io_summary_report` -**Description**: Generate comprehensive I/O analysis report with detailed metrics and recommendations. +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-darshan": { + "command": "uvx", + "args": [ + "clio-kit", + "darshan" + ] + } + } +} +``` -**Parameters**: -- `log_file_path` (str): Path to the Darshan log file -- `include_visualizations` (bool): Whether to include visualization data in the report +Or install the CLIO Kit extension: -**Returns**: dict: Dictionary with complete I/O analysis report and performance insights. +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. HPC Application Performance Analysis diff --git a/clio-kit-mcp-servers/darshan/pyproject.toml b/clio-kit-mcp-servers/darshan/pyproject.toml index 7ce94e53..e63a219f 100644 --- a/clio-kit-mcp-servers/darshan/pyproject.toml +++ b/clio-kit-mcp-servers/darshan/pyproject.toml @@ -20,7 +20,7 @@ keywords = [ ] dependencies = [ - "mcp[cli]>=0.1.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0", "pydantic>=1.10.0", "numpy>=1.24.0", @@ -41,12 +41,6 @@ test = ["pytest>=7.0.0", "pytest-asyncio>=0.21.0"] [project.scripts] darshan-mcp = "darshan_mcp.server:main" -[tool.setuptools.packages.find] -where = ["src"] - -[tool.setuptools.package-dir] -"" = "src" - [tool.uv] dev-dependencies = [ "pytest>=8.4.0", @@ -56,5 +50,13 @@ dev-dependencies = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/darshan_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/darshan/server.json b/clio-kit-mcp-servers/darshan/server.json new file mode 100644 index 00000000..f60c3abc --- /dev/null +++ b/clio-kit-mcp-servers/darshan/server.json @@ -0,0 +1,75 @@ +{ + "name": "io.github.iowarp/darshan-mcp", + "description": "Darshan I/O profiler MCP server for analyzing I/O trace files", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "darshan" + ] + }, + "tools": [ + { + "name": "load_darshan_log", + "description": "Load and parse a Darshan log file to extract I/O performance metrics and metadata." + }, + { + "name": "get_job_summary", + "description": "Get job-level summary from a Darshan log including runtime, process count, and I/O volume." + }, + { + "name": "analyze_file_access_patterns", + "description": "Analyze file access patterns including read/write types and sequential vs random access." + }, + { + "name": "get_io_performance_metrics", + "description": "Extract I/O performance metrics including bandwidth, IOPS, and request sizes." + }, + { + "name": "analyze_posix_operations", + "description": "Analyze POSIX I/O operations including read/write system calls and their frequency." + }, + { + "name": "analyze_mpiio_operations", + "description": "Analyze MPI-IO operations including collective vs independent operations." + }, + { + "name": "identify_io_bottlenecks", + "description": "Identify I/O performance bottlenecks by analyzing access patterns and operations." + }, + { + "name": "get_timeline_analysis", + "description": "Generate timeline analysis showing I/O activity over time and temporal patterns." + }, + { + "name": "compare_darshan_logs", + "description": "Compare two Darshan log files to identify performance differences between runs." + }, + { + "name": "generate_io_summary_report", + "description": "Generate a comprehensive I/O summary report with findings and recommendations." + } + ], + "resources": [ + { + "uri": "darshan://capabilities", + "name": "darshan_capabilities", + "description": "Darshan I/O profiling analysis capabilities." + } + ], + "prompts": [ + { + "name": "analyze_io_performance", + "description": "Guided workflow for analyzing I/O performance from a Darshan log." + } + ], + "tags": [ + "io-profiling", + "performance-analysis", + "hpc", + "darshan" + ] +} diff --git a/clio-kit-mcp-servers/darshan/src/darshan_mcp/server.py b/clio-kit-mcp-servers/darshan/src/darshan_mcp/server.py index 941fbf1d..01bed2ab 100644 --- a/clio-kit-mcp-servers/darshan/src/darshan_mcp/server.py +++ b/clio-kit-mcp-servers/darshan/src/darshan_mcp/server.py @@ -1,15 +1,15 @@ #!/usr/bin/env python3 -""" -Darshan MCP Server for analyzing I/O profiler trace files. -Provides tools to load, explore, and analyze Darshan log files to understand I/O patterns and performance. -""" +"""Darshan MCP Server for analyzing I/O profiler trace files.""" import os -import sys -from mcp.server.fastmcp import FastMCP -from dotenv import load_dotenv import logging -from typing import List, Optional +from typing import Optional + +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +from dotenv import load_dotenv + from darshan_mcp.capabilities import darshan_parser # Configure logging @@ -18,213 +18,297 @@ ) logger = logging.getLogger(__name__) -# Ensure project root is on path -sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) - # Load environment variables load_dotenv() # Initialize MCP server -mcp: FastMCP = FastMCP("DarshanMCP") +mcp: FastMCP = FastMCP( + "darshan", + instructions=( + "Analyzes I/O performance logs from Darshan profiler. " + "Open log files, examine module data, analyze counters, and generate performance insights." + ), + list_page_size=10, +) + + +_READ_ONLY_ANNOTATIONS = { + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, +} @mcp.tool( name="load_darshan_log", - description="Load and parse a Darshan log file to extract I/O performance metrics and metadata. Returns basic information about the trace file including job details, file access patterns, and available modules.", + description="Load and parse a Darshan log file to extract I/O performance metrics and metadata.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "io-analysis"}, ) async def load_darshan_log_tool(log_file_path: str) -> dict: - """ - Load and parse a Darshan log file to extract metadata and basic I/O information. + """Load and parse a Darshan log file to extract metadata and basic I/O information. Args: - log_file_path (str): Absolute path to the .darshan log file + log_file_path: Absolute path to the .darshan log file. Returns: - dict: Dictionary with job information, modules detected, and file count statistics. + Dictionary with job information, modules detected, and file count statistics. """ - return await darshan_parser.load_darshan_log(log_file_path) + result = await darshan_parser.load_darshan_log(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to load Darshan log")) + return result @mcp.tool( name="get_job_summary", - description="Get comprehensive job-level summary from a loaded Darshan log including execution time, number of processes, total I/O volume, and performance metrics.", + description="Get job-level summary from a Darshan log including runtime, process count, and I/O volume.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "io-analysis"}, ) async def get_job_summary_tool(log_file_path: str) -> dict: - """ - Get comprehensive job-level summary including runtime statistics and I/O performance overview. + """Get comprehensive job-level summary including runtime statistics and I/O performance overview. Args: - log_file_path (str): Path to the Darshan log file + log_file_path: Path to the Darshan log file. Returns: - dict: Dictionary with runtime metrics, process information, and I/O volume statistics. + Dictionary with runtime metrics, process information, and I/O volume statistics. """ - return await darshan_parser.get_job_summary(log_file_path) + result = await darshan_parser.get_job_summary(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to get job summary")) + return result @mcp.tool( name="analyze_file_access_patterns", - description="Analyze file access patterns from the trace including which files were accessed, access types (read/write), sequential vs random access patterns, and file size distributions.", + description="Analyze file access patterns including read/write types and sequential vs random access.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "io-analysis"}, ) async def analyze_file_access_patterns_tool( log_file_path: str, file_pattern: Optional[str] = None ) -> dict: - """ - Analyze file access patterns to understand application I/O behavior and optimization opportunities. + """Analyze file access patterns to understand application I/O behavior. Args: - log_file_path (str): Path to the Darshan log file - file_pattern (str, optional): Filter files by pattern (e.g., '*.dat', '/scratch/*') + log_file_path: Path to the Darshan log file. + file_pattern: Filter files by pattern (e.g., '*.dat', '/scratch/*'). Returns: - dict: Dictionary with access pattern analysis including sequential vs random access statistics. + Dictionary with access pattern analysis including sequential vs random access statistics. """ - return await darshan_parser.analyze_file_access_patterns( + result = await darshan_parser.analyze_file_access_patterns( log_file_path, file_pattern ) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to analyze file access patterns")) + return result @mcp.tool( name="get_io_performance_metrics", - description="Extract detailed I/O performance metrics including bandwidth, IOPS, average request sizes, and timing information for read and write operations.", + description="Extract I/O performance metrics including bandwidth, IOPS, and request sizes.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "performance"}, ) async def get_io_performance_metrics_tool(log_file_path: str) -> dict: - """ - Extract detailed I/O performance metrics including bandwidth, IOPS, and request size analysis. + """Extract detailed I/O performance metrics including bandwidth, IOPS, and request size analysis. Args: - log_file_path (str): Path to the Darshan log file + log_file_path: Path to the Darshan log file. Returns: - dict: Dictionary with comprehensive performance metrics and throughput analysis. + Dictionary with comprehensive performance metrics and throughput analysis. """ - return await darshan_parser.get_io_performance_metrics(log_file_path) + result = await darshan_parser.get_io_performance_metrics(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to get I/O performance metrics")) + return result @mcp.tool( name="analyze_posix_operations", - description="Analyze POSIX I/O operations from the trace including read/write system calls, file operations (open, close, seek), and their frequency and timing patterns.", + description="Analyze POSIX I/O operations including read/write system calls and their frequency.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "io-analysis"}, ) async def analyze_posix_operations_tool(log_file_path: str) -> dict: - """ - Analyze POSIX system call patterns including open, read, write, and seek operations. + """Analyze POSIX system call patterns including open, read, write, and seek operations. Args: - log_file_path (str): Path to the Darshan log file + log_file_path: Path to the Darshan log file. Returns: - dict: Dictionary with POSIX operation statistics and system call analysis. + Dictionary with POSIX operation statistics and system call analysis. """ - return await darshan_parser.analyze_posix_operations(log_file_path) + result = await darshan_parser.analyze_posix_operations(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to analyze POSIX operations")) + return result @mcp.tool( name="analyze_mpiio_operations", - description="Analyze MPI-IO operations if present in the trace, including collective vs independent operations, file view usage, and MPI-IO specific performance metrics.", + description="Analyze MPI-IO operations including collective vs independent operations.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "io-analysis"}, ) async def analyze_mpiio_operations_tool(log_file_path: str) -> dict: - """ - Analyze MPI-IO operations including collective vs independent I/O patterns and performance. + """Analyze MPI-IO operations including collective vs independent I/O patterns. Args: - log_file_path (str): Path to the Darshan log file + log_file_path: Path to the Darshan log file. Returns: - dict: Dictionary with MPI-IO operation analysis and collective I/O performance metrics. + Dictionary with MPI-IO operation analysis and collective I/O performance metrics. """ - return await darshan_parser.analyze_mpiio_operations(log_file_path) + result = await darshan_parser.analyze_mpiio_operations(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to analyze MPI-IO operations")) + return result @mcp.tool( name="identify_io_bottlenecks", - description="Identify potential I/O performance bottlenecks by analyzing access patterns, file system usage, small vs large I/O operations, and synchronization patterns.", + description="Identify I/O performance bottlenecks by analyzing access patterns and operations.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "performance"}, ) async def identify_io_bottlenecks_tool(log_file_path: str) -> dict: - """ - Automatically identify potential I/O performance bottlenecks and optimization opportunities. + """Identify potential I/O performance bottlenecks and optimization opportunities. Args: - log_file_path (str): Path to the Darshan log file + log_file_path: Path to the Darshan log file. Returns: - dict: Dictionary with identified performance issues and recommended optimizations. + Dictionary with identified performance issues and recommended optimizations. """ - return await darshan_parser.identify_io_bottlenecks(log_file_path) + result = await darshan_parser.identify_io_bottlenecks(log_file_path) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to identify I/O bottlenecks")) + return result @mcp.tool( name="get_timeline_analysis", - description="Generate timeline analysis showing I/O activity over time, including peak I/O periods, idle times, and temporal patterns in file access.", + description="Generate timeline analysis showing I/O activity over time and temporal patterns.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "performance"}, ) async def get_timeline_analysis_tool( log_file_path: str, time_resolution: str = "1s" ) -> dict: - """ - Generate temporal analysis of I/O activity to understand performance patterns over time. + """Generate temporal analysis of I/O activity to understand performance patterns over time. Args: - log_file_path (str): Path to the Darshan log file - time_resolution (str): Time resolution for analysis (e.g., '1s', '100ms') + log_file_path: Path to the Darshan log file. + time_resolution: Time resolution for analysis (e.g., '1s', '100ms'). Returns: - dict: Dictionary with timeline analysis and temporal I/O patterns. + Dictionary with timeline analysis and temporal I/O patterns. """ - return await darshan_parser.get_timeline_analysis(log_file_path, time_resolution) + result = await darshan_parser.get_timeline_analysis(log_file_path, time_resolution) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to get timeline analysis")) + return result @mcp.tool( name="compare_darshan_logs", - description="Compare two Darshan log files to identify differences in I/O patterns, performance changes, and behavioral variations between different runs or configurations.", + description="Compare two Darshan log files to identify performance differences between runs.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "performance"}, ) async def compare_darshan_logs_tool( - log_file_1: str, log_file_2: str, comparison_metrics: Optional[List[str]] = None + log_file_1: str, log_file_2: str, comparison_metrics: Optional[list[str]] = None ) -> dict: - """ - Compare two Darshan log files to identify performance differences and optimization results. + """Compare two Darshan log files to identify performance differences. Args: - log_file_1 (str): Path to the first log file - log_file_2 (str): Path to the second log file - comparison_metrics (list): List of metrics to compare ['bandwidth', 'iops', 'file_count'] + log_file_1: Path to the first log file. + log_file_2: Path to the second log file. + comparison_metrics: List of metrics to compare ['bandwidth', 'iops', 'file_count']. Returns: - dict: Dictionary with comparative analysis and performance delta identification. + Dictionary with comparative analysis and performance delta identification. """ if comparison_metrics is None: comparison_metrics = ["bandwidth", "iops", "file_count"] - return await darshan_parser.compare_darshan_logs( + result = await darshan_parser.compare_darshan_logs( log_file_1, log_file_2, comparison_metrics ) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to compare Darshan logs")) + return result @mcp.tool( name="generate_io_summary_report", - description="Generate a comprehensive I/O summary report combining all analysis results into a human-readable format with key findings, performance insights, and recommendations.", + description="Generate a comprehensive I/O summary report with findings and recommendations.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"darshan", "performance"}, ) async def generate_io_summary_report_tool( log_file_path: str, include_visualizations: bool = False ) -> dict: - """ - Generate comprehensive I/O analysis report with detailed metrics and recommendations. + """Generate comprehensive I/O analysis report with detailed metrics and recommendations. Args: - log_file_path (str): Path to the Darshan log file - include_visualizations (bool): Whether to include visualization data in the report + log_file_path: Path to the Darshan log file. + include_visualizations: Whether to include visualization data in the report. Returns: - dict: Dictionary with complete I/O analysis report and performance insights. + Dictionary with complete I/O analysis report and performance insights. """ - return await darshan_parser.generate_io_summary_report( + result = await darshan_parser.generate_io_summary_report( log_file_path, include_visualizations ) - - -def main(): - """Main entry point for the server.""" - import asyncio - - # Run the FastMCP server - asyncio.run(mcp.run()) + if not result.get("success", False): + raise ToolError(result.get("error", "Failed to generate I/O summary report")) + return result + + +@mcp.resource("darshan://capabilities") +def darshan_capabilities() -> dict: + """Darshan I/O profiling analysis capabilities.""" + return { + "supported_formats": ["darshan log files (.darshan)"], + "analysis_types": [ + "module counters", + "file records", + "I/O patterns", + "performance summary", + ], + } + + +@mcp.prompt() +def analyze_io_performance(log_path: str) -> list[Message]: + """Guided workflow for analyzing I/O performance from a Darshan log.""" + return [ + Message( + f"I need to analyze the I/O performance in the Darshan log at {log_path}. " + "Open the log, list available modules, show key counters, and provide a performance summary." + ), + ] + + +def main() -> None: + """Main entry point for the Darshan MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Darshan MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + else: + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser.py b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser.py index be0c7228..0bb9d2dc 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser.py +++ b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.capabilities import darshan_parser diff --git a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_error_paths.py b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_error_paths.py index e10c8c1f..7989c3c1 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_error_paths.py +++ b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_error_paths.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.capabilities import darshan_parser diff --git a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_posix_mpiio.py b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_posix_mpiio.py index 2c271d32..03b6390b 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_posix_mpiio.py +++ b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_posix_mpiio.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.capabilities import darshan_parser diff --git a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_text_parsing.py b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_text_parsing.py index d96a8d8c..7961b985 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_text_parsing.py +++ b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_text_parsing.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch, AsyncMock -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.capabilities import darshan_parser diff --git a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_timeline.py b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_timeline.py index f7f5efac..ee1f9325 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_timeline.py +++ b/clio-kit-mcp-servers/darshan/tests/test_darshan_parser_timeline.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.capabilities import darshan_parser diff --git a/clio-kit-mcp-servers/darshan/tests/test_server.py b/clio-kit-mcp-servers/darshan/tests/test_server.py index 91bcc24f..dd6346e1 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_server.py +++ b/clio-kit-mcp-servers/darshan/tests/test_server.py @@ -2,11 +2,6 @@ import pytest from unittest.mock import patch, AsyncMock -import sys -import os - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp.server import ( load_darshan_log_tool, diff --git a/clio-kit-mcp-servers/darshan/tests/test_server_main.py b/clio-kit-mcp-servers/darshan/tests/test_server_main.py index d43a43d3..8ca8a041 100644 --- a/clio-kit-mcp-servers/darshan/tests/test_server_main.py +++ b/clio-kit-mcp-servers/darshan/tests/test_server_main.py @@ -2,33 +2,32 @@ import pytest from unittest.mock import patch -import os -import sys - -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) from darshan_mcp import server def test_main_function(): - """Test the main function executes asyncio.run.""" - with patch("asyncio.run") as mock_run: - with patch.object(server.mcp, "run", return_value=None): + """Test the main function calls mcp.run with default transport.""" + with patch.object(server.mcp, "run", return_value=None) as mock_run: + with patch("argparse.ArgumentParser.parse_args") as mock_args: + mock_args.return_value = type( + "Args", (), {"transport": None, "host": "0.0.0.0", "port": 8000} + )() server.main() - mock_run.assert_called_once() + mock_run.assert_called_once_with(transport="stdio") def test_main_function_callable(): """Test that the main function is callable and properly configured.""" - with patch("asyncio.run") as mock_run: - with patch.object(server.mcp, "run", return_value=None): + with patch.object(server.mcp, "run", return_value=None) as mock_run: + with patch("argparse.ArgumentParser.parse_args") as mock_args: + mock_args.return_value = type( + "Args", (), {"transport": "http", "host": "127.0.0.1", "port": 9000} + )() server.main() - # Verify asyncio.run was called - assert mock_run.called - # Verify it was called with the mcp.run() coroutine - call_args = mock_run.call_args - assert call_args is not None + mock_run.assert_called_once_with( + transport="http", host="127.0.0.1", port=9000 + ) @pytest.mark.asyncio diff --git a/clio-kit-mcp-servers/darshan/uv.lock b/clio-kit-mcp-servers/darshan/uv.lock index d6dca462..fcc38e96 100644 --- a/clio-kit-mcp-servers/darshan/uv.lock +++ b/clio-kit-mcp-servers/darshan/uv.lock @@ -40,6 +40,45 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" }, ] +[[package]] +name = "authlib" +version = "1.6.8" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "cryptography" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/6b/6c/c88eac87468c607f88bc24df1f3b31445ee6fc9ba123b09e666adf687cd9/authlib-1.6.8.tar.gz", hash = "sha256:41ae180a17cf672bc784e4a518e5c82687f1fe1e98b0cafaeda80c8e4ab2d1cb", size = 165074, upload-time = "2026-02-14T04:02:17.941Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9b/73/f7084bf12755113cd535ae586782ff3a6e710bfbe6a0d13d1c2f81ffbbfa/authlib-1.6.8-py2.py3-none-any.whl", hash = "sha256:97286fd7a15e6cfefc32771c8ef9c54f0ed58028f1322de6a2a7c969c3817888", size = 244116, upload-time = "2026-02-14T04:02:15.579Z" }, +] + +[[package]] +name = "backports-tarfile" +version = "1.2.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/86/72/cd9b395f25e290e633655a100af28cb253e4393396264a98bd5f5951d50f/backports_tarfile-1.2.0.tar.gz", hash = "sha256:d75e02c268746e1b8144c278978b6e98e85de6ad16f8e4b0844a154557eca991", size = 86406, upload-time = "2024-05-28T17:01:54.731Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b9/fa/123043af240e49752f1c4bd24da5053b6bd00cad78c2be53c0d1e8b975bc/backports.tarfile-1.2.0-py3-none-any.whl", hash = "sha256:77e284d754527b01fb1e6fa8a1afe577858ebe4e9dad8919e34c862cb399bc34", size = 30181, upload-time = "2024-05-28T17:01:53.112Z" }, +] + +[[package]] +name = "beartype" +version = "0.22.9" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/94/1009e248bbfbab11397abca7193bea6626806be9a327d399810d523a07cb/beartype-0.22.9.tar.gz", hash = "sha256:8f82b54aa723a2848a56008d18875f91c1db02c32ef6a62319a002e3e25a975f", size = 1608866, upload-time = "2025-12-13T06:50:30.72Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/71/cc/18245721fa7747065ab478316c7fea7c74777d07f37ae60db2e84f8172e8/beartype-0.22.9-py3-none-any.whl", hash = "sha256:d16c9bbc61ea14637596c5f6fbff2ee99cbe3573e46a716401734ef50c3060c2", size = 1333658, upload-time = "2025-12-13T06:50:28.266Z" }, +] + +[[package]] +name = "cachetools" +version = "7.0.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d4/07/56595285564e90777d758ebd383d6b0b971b87729bbe2184a849932a3736/cachetools-7.0.1.tar.gz", hash = "sha256:e31e579d2c5b6e2944177a0397150d312888ddf4e16e12f1016068f0c03b8341", size = 36126, upload-time = "2026-02-10T22:24:05.03Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ed/9e/5faefbf9db1db466d633735faceda1f94aa99ce506ac450d232536266b32/cachetools-7.0.1-py3-none-any.whl", hash = "sha256:8f086515c254d5664ae2146d14fc7f65c9a4bce75152eb247e5a9c5e6d7b2ecf", size = 13484, upload-time = "2026-02-10T22:24:03.741Z" }, +] + [[package]] name = "certifi" version = "2025.6.15" @@ -131,6 +170,95 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" }, ] +[[package]] +name = "charset-normalizer" +version = "3.4.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1f/b8/6d51fc1d52cbd52cd4ccedd5b5b2f0f6a11bbf6765c782298b0f3e808541/charset_normalizer-3.4.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e824f1492727fa856dd6eda4f7cee25f8518a12f3c4a56a74e8095695089cf6d", size = 209709, upload-time = "2025-10-14T04:40:11.385Z" }, + { url = "https://files.pythonhosted.org/packages/5c/af/1f9d7f7faafe2ddfb6f72a2e07a548a629c61ad510fe60f9630309908fef/charset_normalizer-3.4.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4bd5d4137d500351a30687c2d3971758aac9a19208fc110ccb9d7188fbe709e8", size = 148814, upload-time = "2025-10-14T04:40:13.135Z" }, + { url = "https://files.pythonhosted.org/packages/79/3d/f2e3ac2bbc056ca0c204298ea4e3d9db9b4afe437812638759db2c976b5f/charset_normalizer-3.4.4-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:027f6de494925c0ab2a55eab46ae5129951638a49a34d87f4c3eda90f696b4ad", size = 144467, upload-time = "2025-10-14T04:40:14.728Z" }, + { url = "https://files.pythonhosted.org/packages/ec/85/1bf997003815e60d57de7bd972c57dc6950446a3e4ccac43bc3070721856/charset_normalizer-3.4.4-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f820802628d2694cb7e56db99213f930856014862f3fd943d290ea8438d07ca8", size = 162280, upload-time = "2025-10-14T04:40:16.14Z" }, + { url = "https://files.pythonhosted.org/packages/3e/8e/6aa1952f56b192f54921c436b87f2aaf7c7a7c3d0d1a765547d64fd83c13/charset_normalizer-3.4.4-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:798d75d81754988d2565bff1b97ba5a44411867c0cf32b77a7e8f8d84796b10d", size = 159454, upload-time = "2025-10-14T04:40:17.567Z" }, + { url = "https://files.pythonhosted.org/packages/36/3b/60cbd1f8e93aa25d1c669c649b7a655b0b5fb4c571858910ea9332678558/charset_normalizer-3.4.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d1bb833febdff5c8927f922386db610b49db6e0d4f4ee29601d71e7c2694313", size = 153609, upload-time = "2025-10-14T04:40:19.08Z" }, + { url = "https://files.pythonhosted.org/packages/64/91/6a13396948b8fd3c4b4fd5bc74d045f5637d78c9675585e8e9fbe5636554/charset_normalizer-3.4.4-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9cd98cdc06614a2f768d2b7286d66805f94c48cde050acdbbb7db2600ab3197e", size = 151849, upload-time = "2025-10-14T04:40:20.607Z" }, + { url = "https://files.pythonhosted.org/packages/b7/7a/59482e28b9981d105691e968c544cc0df3b7d6133152fb3dcdc8f135da7a/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:077fbb858e903c73f6c9db43374fd213b0b6a778106bc7032446a8e8b5b38b93", size = 151586, upload-time = "2025-10-14T04:40:21.719Z" }, + { url = "https://files.pythonhosted.org/packages/92/59/f64ef6a1c4bdd2baf892b04cd78792ed8684fbc48d4c2afe467d96b4df57/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:244bfb999c71b35de57821b8ea746b24e863398194a4014e4c76adc2bbdfeff0", size = 145290, upload-time = "2025-10-14T04:40:23.069Z" }, + { url = "https://files.pythonhosted.org/packages/6b/63/3bf9f279ddfa641ffa1962b0db6a57a9c294361cc2f5fcac997049a00e9c/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:64b55f9dce520635f018f907ff1b0df1fdc31f2795a922fb49dd14fbcdf48c84", size = 163663, upload-time = "2025-10-14T04:40:24.17Z" }, + { url = "https://files.pythonhosted.org/packages/ed/09/c9e38fc8fa9e0849b172b581fd9803bdf6e694041127933934184e19f8c3/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:faa3a41b2b66b6e50f84ae4a68c64fcd0c44355741c6374813a800cd6695db9e", size = 151964, upload-time = "2025-10-14T04:40:25.368Z" }, + { url = "https://files.pythonhosted.org/packages/d2/d1/d28b747e512d0da79d8b6a1ac18b7ab2ecfd81b2944c4c710e166d8dd09c/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:6515f3182dbe4ea06ced2d9e8666d97b46ef4c75e326b79bb624110f122551db", size = 161064, upload-time = "2025-10-14T04:40:26.806Z" }, + { url = "https://files.pythonhosted.org/packages/bb/9a/31d62b611d901c3b9e5500c36aab0ff5eb442043fb3a1c254200d3d397d9/charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:cc00f04ed596e9dc0da42ed17ac5e596c6ccba999ba6bd92b0e0aef2f170f2d6", size = 155015, upload-time = "2025-10-14T04:40:28.284Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/107e008fa2bff0c8b9319584174418e5e5285fef32f79d8ee6a430d0039c/charset_normalizer-3.4.4-cp310-cp310-win32.whl", hash = "sha256:f34be2938726fc13801220747472850852fe6b1ea75869a048d6f896838c896f", size = 99792, upload-time = "2025-10-14T04:40:29.613Z" }, + { url = "https://files.pythonhosted.org/packages/eb/66/e396e8a408843337d7315bab30dbf106c38966f1819f123257f5520f8a96/charset_normalizer-3.4.4-cp310-cp310-win_amd64.whl", hash = "sha256:a61900df84c667873b292c3de315a786dd8dac506704dea57bc957bd31e22c7d", size = 107198, upload-time = "2025-10-14T04:40:30.644Z" }, + { url = "https://files.pythonhosted.org/packages/b5/58/01b4f815bf0312704c267f2ccb6e5d42bcc7752340cd487bc9f8c3710597/charset_normalizer-3.4.4-cp310-cp310-win_arm64.whl", hash = "sha256:cead0978fc57397645f12578bfd2d5ea9138ea0fac82b2f63f7f7c6877986a69", size = 100262, upload-time = "2025-10-14T04:40:32.108Z" }, + { url = "https://files.pythonhosted.org/packages/ed/27/c6491ff4954e58a10f69ad90aca8a1b6fe9c5d3c6f380907af3c37435b59/charset_normalizer-3.4.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8", size = 206988, upload-time = "2025-10-14T04:40:33.79Z" }, + { url = "https://files.pythonhosted.org/packages/94/59/2e87300fe67ab820b5428580a53cad894272dbb97f38a7a814a2a1ac1011/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0", size = 147324, upload-time = "2025-10-14T04:40:34.961Z" }, + { url = "https://files.pythonhosted.org/packages/07/fb/0cf61dc84b2b088391830f6274cb57c82e4da8bbc2efeac8c025edb88772/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3", size = 142742, upload-time = "2025-10-14T04:40:36.105Z" }, + { url = "https://files.pythonhosted.org/packages/62/8b/171935adf2312cd745d290ed93cf16cf0dfe320863ab7cbeeae1dcd6535f/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc", size = 160863, upload-time = "2025-10-14T04:40:37.188Z" }, + { url = "https://files.pythonhosted.org/packages/09/73/ad875b192bda14f2173bfc1bc9a55e009808484a4b256748d931b6948442/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897", size = 157837, upload-time = "2025-10-14T04:40:38.435Z" }, + { url = "https://files.pythonhosted.org/packages/6d/fc/de9cce525b2c5b94b47c70a4b4fb19f871b24995c728e957ee68ab1671ea/charset_normalizer-3.4.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381", size = 151550, upload-time = "2025-10-14T04:40:40.053Z" }, + { url = "https://files.pythonhosted.org/packages/55/c2/43edd615fdfba8c6f2dfbd459b25a6b3b551f24ea21981e23fb768503ce1/charset_normalizer-3.4.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815", size = 149162, upload-time = "2025-10-14T04:40:41.163Z" }, + { url = "https://files.pythonhosted.org/packages/03/86/bde4ad8b4d0e9429a4e82c1e8f5c659993a9a863ad62c7df05cf7b678d75/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0", size = 150019, upload-time = "2025-10-14T04:40:42.276Z" }, + { url = "https://files.pythonhosted.org/packages/1f/86/a151eb2af293a7e7bac3a739b81072585ce36ccfb4493039f49f1d3cae8c/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161", size = 143310, upload-time = "2025-10-14T04:40:43.439Z" }, + { url = "https://files.pythonhosted.org/packages/b5/fe/43dae6144a7e07b87478fdfc4dbe9efd5defb0e7ec29f5f58a55aeef7bf7/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4", size = 162022, upload-time = "2025-10-14T04:40:44.547Z" }, + { url = "https://files.pythonhosted.org/packages/80/e6/7aab83774f5d2bca81f42ac58d04caf44f0cc2b65fc6db2b3b2e8a05f3b3/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89", size = 149383, upload-time = "2025-10-14T04:40:46.018Z" }, + { url = "https://files.pythonhosted.org/packages/4f/e8/b289173b4edae05c0dde07f69f8db476a0b511eac556dfe0d6bda3c43384/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569", size = 159098, upload-time = "2025-10-14T04:40:47.081Z" }, + { url = "https://files.pythonhosted.org/packages/d8/df/fe699727754cae3f8478493c7f45f777b17c3ef0600e28abfec8619eb49c/charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224", size = 152991, upload-time = "2025-10-14T04:40:48.246Z" }, + { url = "https://files.pythonhosted.org/packages/1a/86/584869fe4ddb6ffa3bd9f491b87a01568797fb9bd8933f557dba9771beaf/charset_normalizer-3.4.4-cp311-cp311-win32.whl", hash = "sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a", size = 99456, upload-time = "2025-10-14T04:40:49.376Z" }, + { url = "https://files.pythonhosted.org/packages/65/f6/62fdd5feb60530f50f7e38b4f6a1d5203f4d16ff4f9f0952962c044e919a/charset_normalizer-3.4.4-cp311-cp311-win_amd64.whl", hash = "sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016", size = 106978, upload-time = "2025-10-14T04:40:50.844Z" }, + { url = "https://files.pythonhosted.org/packages/7a/9d/0710916e6c82948b3be62d9d398cb4fcf4e97b56d6a6aeccd66c4b2f2bd5/charset_normalizer-3.4.4-cp311-cp311-win_arm64.whl", hash = "sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1", size = 99969, upload-time = "2025-10-14T04:40:52.272Z" }, + { url = "https://files.pythonhosted.org/packages/f3/85/1637cd4af66fa687396e757dec650f28025f2a2f5a5531a3208dc0ec43f2/charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394", size = 208425, upload-time = "2025-10-14T04:40:53.353Z" }, + { url = "https://files.pythonhosted.org/packages/9d/6a/04130023fef2a0d9c62d0bae2649b69f7b7d8d24ea5536feef50551029df/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25", size = 148162, upload-time = "2025-10-14T04:40:54.558Z" }, + { url = "https://files.pythonhosted.org/packages/78/29/62328d79aa60da22c9e0b9a66539feae06ca0f5a4171ac4f7dc285b83688/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef", size = 144558, upload-time = "2025-10-14T04:40:55.677Z" }, + { url = "https://files.pythonhosted.org/packages/86/bb/b32194a4bf15b88403537c2e120b817c61cd4ecffa9b6876e941c3ee38fe/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d", size = 161497, upload-time = "2025-10-14T04:40:57.217Z" }, + { url = "https://files.pythonhosted.org/packages/19/89/a54c82b253d5b9b111dc74aca196ba5ccfcca8242d0fb64146d4d3183ff1/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8", size = 159240, upload-time = "2025-10-14T04:40:58.358Z" }, + { url = "https://files.pythonhosted.org/packages/c0/10/d20b513afe03acc89ec33948320a5544d31f21b05368436d580dec4e234d/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86", size = 153471, upload-time = "2025-10-14T04:40:59.468Z" }, + { url = "https://files.pythonhosted.org/packages/61/fa/fbf177b55bdd727010f9c0a3c49eefa1d10f960e5f09d1d887bf93c2e698/charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a", size = 150864, upload-time = "2025-10-14T04:41:00.623Z" }, + { url = "https://files.pythonhosted.org/packages/05/12/9fbc6a4d39c0198adeebbde20b619790e9236557ca59fc40e0e3cebe6f40/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f", size = 150647, upload-time = "2025-10-14T04:41:01.754Z" }, + { url = "https://files.pythonhosted.org/packages/ad/1f/6a9a593d52e3e8c5d2b167daf8c6b968808efb57ef4c210acb907c365bc4/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc", size = 145110, upload-time = "2025-10-14T04:41:03.231Z" }, + { url = "https://files.pythonhosted.org/packages/30/42/9a52c609e72471b0fc54386dc63c3781a387bb4fe61c20231a4ebcd58bdd/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf", size = 162839, upload-time = "2025-10-14T04:41:04.715Z" }, + { url = "https://files.pythonhosted.org/packages/c4/5b/c0682bbf9f11597073052628ddd38344a3d673fda35a36773f7d19344b23/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15", size = 150667, upload-time = "2025-10-14T04:41:05.827Z" }, + { url = "https://files.pythonhosted.org/packages/e4/24/a41afeab6f990cf2daf6cb8c67419b63b48cf518e4f56022230840c9bfb2/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9", size = 160535, upload-time = "2025-10-14T04:41:06.938Z" }, + { url = "https://files.pythonhosted.org/packages/2a/e5/6a4ce77ed243c4a50a1fecca6aaaab419628c818a49434be428fe24c9957/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0", size = 154816, upload-time = "2025-10-14T04:41:08.101Z" }, + { url = "https://files.pythonhosted.org/packages/a8/ef/89297262b8092b312d29cdb2517cb1237e51db8ecef2e9af5edbe7b683b1/charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26", size = 99694, upload-time = "2025-10-14T04:41:09.23Z" }, + { url = "https://files.pythonhosted.org/packages/3d/2d/1e5ed9dd3b3803994c155cd9aacb60c82c331bad84daf75bcb9c91b3295e/charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525", size = 107131, upload-time = "2025-10-14T04:41:10.467Z" }, + { url = "https://files.pythonhosted.org/packages/d0/d9/0ed4c7098a861482a7b6a95603edce4c0d9db2311af23da1fb2b75ec26fc/charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3", size = 100390, upload-time = "2025-10-14T04:41:11.915Z" }, + { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" }, + { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" }, + { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" }, + { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" }, + { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" }, + { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" }, + { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" }, + { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" }, + { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" }, + { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" }, + { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" }, + { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" }, + { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" }, + { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" }, + { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" }, + { url = "https://files.pythonhosted.org/packages/2a/35/7051599bd493e62411d6ede36fd5af83a38f37c4767b92884df7301db25d/charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd", size = 207746, upload-time = "2025-10-14T04:41:33.773Z" }, + { url = "https://files.pythonhosted.org/packages/10/9a/97c8d48ef10d6cd4fcead2415523221624bf58bcf68a802721a6bc807c8f/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb", size = 147889, upload-time = "2025-10-14T04:41:34.897Z" }, + { url = "https://files.pythonhosted.org/packages/10/bf/979224a919a1b606c82bd2c5fa49b5c6d5727aa47b4312bb27b1734f53cd/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e", size = 143641, upload-time = "2025-10-14T04:41:36.116Z" }, + { url = "https://files.pythonhosted.org/packages/ba/33/0ad65587441fc730dc7bd90e9716b30b4702dc7b617e6ba4997dc8651495/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14", size = 160779, upload-time = "2025-10-14T04:41:37.229Z" }, + { url = "https://files.pythonhosted.org/packages/67/ed/331d6b249259ee71ddea93f6f2f0a56cfebd46938bde6fcc6f7b9a3d0e09/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191", size = 159035, upload-time = "2025-10-14T04:41:38.368Z" }, + { url = "https://files.pythonhosted.org/packages/67/ff/f6b948ca32e4f2a4576aa129d8bed61f2e0543bf9f5f2b7fc3758ed005c9/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838", size = 152542, upload-time = "2025-10-14T04:41:39.862Z" }, + { url = "https://files.pythonhosted.org/packages/16/85/276033dcbcc369eb176594de22728541a925b2632f9716428c851b149e83/charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6", size = 149524, upload-time = "2025-10-14T04:41:41.319Z" }, + { url = "https://files.pythonhosted.org/packages/9e/f2/6a2a1f722b6aba37050e626530a46a68f74e63683947a8acff92569f979a/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e", size = 150395, upload-time = "2025-10-14T04:41:42.539Z" }, + { url = "https://files.pythonhosted.org/packages/60/bb/2186cb2f2bbaea6338cad15ce23a67f9b0672929744381e28b0592676824/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c", size = 143680, upload-time = "2025-10-14T04:41:43.661Z" }, + { url = "https://files.pythonhosted.org/packages/7d/a5/bf6f13b772fbb2a90360eb620d52ed8f796f3c5caee8398c3b2eb7b1c60d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090", size = 162045, upload-time = "2025-10-14T04:41:44.821Z" }, + { url = "https://files.pythonhosted.org/packages/df/c5/d1be898bf0dc3ef9030c3825e5d3b83f2c528d207d246cbabe245966808d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152", size = 149687, upload-time = "2025-10-14T04:41:46.442Z" }, + { url = "https://files.pythonhosted.org/packages/a5/42/90c1f7b9341eef50c8a1cb3f098ac43b0508413f33affd762855f67a410e/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828", size = 160014, upload-time = "2025-10-14T04:41:47.631Z" }, + { url = "https://files.pythonhosted.org/packages/76/be/4d3ee471e8145d12795ab655ece37baed0929462a86e72372fd25859047c/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec", size = 154044, upload-time = "2025-10-14T04:41:48.81Z" }, + { url = "https://files.pythonhosted.org/packages/b0/6f/8f7af07237c34a1defe7defc565a9bc1807762f672c0fde711a4b22bf9c0/charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9", size = 99940, upload-time = "2025-10-14T04:41:49.946Z" }, + { url = "https://files.pythonhosted.org/packages/4b/51/8ade005e5ca5b0d80fb4aff72a3775b325bdc3d27408c8113811a7cbe640/charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c", size = 107104, upload-time = "2025-10-14T04:41:51.051Z" }, + { url = "https://files.pythonhosted.org/packages/da/5f/6b8f83a55bb8278772c5ae54a577f3099025f9ade59d0136ac24a0df4bde/charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2", size = 100743, upload-time = "2025-10-14T04:41:52.122Z" }, + { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" }, +] + [[package]] name = "click" version = "8.2.1" @@ -398,14 +526,31 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/e7/05/c19819d5e3d95294a6f5947fb9b9629efb316b96de511b418c53d245aae6/cycler-0.12.1-py3-none-any.whl", hash = "sha256:85cef7cff222d8644161529808465972e51340599459b8ac3ccbac5a854e0d30", size = 8321, upload-time = "2023-10-07T05:32:16.783Z" }, ] +[[package]] +name = "cyclopts" +version = "4.5.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "attrs" }, + { name = "docstring-parser" }, + { name = "rich" }, + { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, + { name = "typing-extensions", marker = "python_full_version < '3.11'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, +] + [[package]] name = "darshan-mcp" version = "1.0.0" source = { editable = "." } dependencies = [ + { name = "fastmcp" }, { name = "h5py" }, { name = "matplotlib" }, - { name = "mcp", extra = ["cli"] }, { name = "numpy", version = "2.2.6", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11'" }, { name = "numpy", version = "2.3.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11'" }, { name = "pandas" }, @@ -432,9 +577,9 @@ dev = [ [package.metadata] requires-dist = [ + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "h5py", specifier = ">=3.8.0" }, { name = "matplotlib", specifier = ">=3.7.0" }, - { name = "mcp", extras = ["cli"], specifier = ">=0.1.0" }, { name = "numpy", specifier = ">=1.24.0" }, { name = "pandas", specifier = ">=2.0.0" }, { name = "pydantic", specifier = ">=1.10.0" }, @@ -454,18 +599,98 @@ dev = [ { name = "ruff", specifier = ">=0.12.5" }, ] +[[package]] +name = "diskcache" +version = "5.6.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/3f/21/1c1ffc1a039ddcc459db43cc108658f32c57d271d7289a2794e401d0fdb6/diskcache-5.6.3.tar.gz", hash = "sha256:2c3a3fa2743d8535d832ec61c2054a1641f41775aa7c556758a109941e33e4fc", size = 67916, upload-time = "2023-08-31T06:12:00.316Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/3f/27/4570e78fc0bf5ea0ca45eb1de3818a23787af9b390c0b0a0033a1b8236f9/diskcache-5.6.3-py3-none-any.whl", hash = "sha256:5e31b2d5fbad117cc363ebaf6b689474db18a1f6438bc82358b024abd4c2ca19", size = 45550, upload-time = "2023-08-31T06:11:58.822Z" }, +] + +[[package]] +name = "dnspython" +version = "2.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/8c/8b/57666417c0f90f08bcafa776861060426765fdb422eb10212086fb811d26/dnspython-2.8.0.tar.gz", hash = "sha256:181d3c6996452cb1189c4046c61599b84a5a86e099562ffde77d26984ff26d0f", size = 368251, upload-time = "2025-09-07T18:58:00.022Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ba/5a/18ad964b0086c6e62e2e7500f7edc89e3faa45033c71c1893d34eed2b2de/dnspython-2.8.0-py3-none-any.whl", hash = "sha256:01d9bbc4a2d76bf0db7c1f729812ded6d912bd318d3b1cf81d30c0f845dbf3af", size = 331094, upload-time = "2025-09-07T18:57:58.071Z" }, +] + +[[package]] +name = "docstring-parser" +version = "0.17.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/b2/9d/c3b43da9515bd270df0f80548d9944e389870713cc1fe2b8fb35fe2bcefd/docstring_parser-0.17.0.tar.gz", hash = "sha256:583de4a309722b3315439bb31d64ba3eebada841f2e2cee23b99df001434c912", size = 27442, upload-time = "2025-07-21T07:35:01.868Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/55/e2/2537ebcff11c1ee1ff17d8d0b6f4db75873e3b0fb32c2d4a2ee31ecb310a/docstring_parser-0.17.0-py3-none-any.whl", hash = "sha256:cf2569abd23dce8099b300f9b4fa8191e9582dda731fd533daf54c4551658708", size = 36896, upload-time = "2025-07-21T07:35:00.684Z" }, +] + +[[package]] +name = "docutils" +version = "0.22.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ae/b6/03bb70946330e88ffec97aefd3ea75ba575cb2e762061e0e62a213befee8/docutils-0.22.4.tar.gz", hash = "sha256:4db53b1fde9abecbb74d91230d32ab626d94f6badfc575d6db9194a49df29968", size = 2291750, upload-time = "2025-12-18T19:00:26.443Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/02/10/5da547df7a391dcde17f59520a231527b8571e6f46fc8efb02ccb370ab12/docutils-0.22.4-py3-none-any.whl", hash = "sha256:d0013f540772d1420576855455d050a2180186c91c15779301ac2ccb3eeb68de", size = 633196, upload-time = "2025-12-18T19:00:18.077Z" }, +] + +[[package]] +name = "email-validator" +version = "2.3.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "dnspython" }, + { name = "idna" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f5/22/900cb125c76b7aaa450ce02fd727f452243f2e91a61af068b40adba60ea9/email_validator-2.3.0.tar.gz", hash = "sha256:9fc05c37f2f6cf439ff414f8fc46d917929974a82244c20eb10231ba60c54426", size = 51238, upload-time = "2025-08-26T13:09:06.831Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/de/15/545e2b6cf2e3be84bc1ed85613edd75b8aea69807a71c26f4ca6a9258e82/email_validator-2.3.0-py3-none-any.whl", hash = "sha256:80f13f623413e6b197ae73bb10bf4eb0908faf509ad8362c5edeb0be7fd450b4", size = 35604, upload-time = "2025-08-26T13:09:05.858Z" }, +] + [[package]] name = "exceptiongroup" version = "1.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "typing-extensions", marker = "python_full_version < '3.11'" }, + { name = "typing-extensions", marker = "python_full_version < '3.13'" }, ] sdist = { url = "https://files.pythonhosted.org/packages/0b/9f/a65090624ecf468cdca03533906e7c69ed7588582240cfe7cc9e770b50eb/exceptiongroup-1.3.0.tar.gz", hash = "sha256:b241f5885f560bc56a59ee63ca4c6a8bfa46ae4ad651af316d4e81817bb9fd88", size = 29749, upload-time = "2025-05-10T17:42:51.123Z" } wheels = [ { url = "https://files.pythonhosted.org/packages/36/f4/c6e662dade71f56cd2f3735141b265c3c79293c109549c1e6933b0651ffc/exceptiongroup-1.3.0-py3-none-any.whl", hash = "sha256:4d111e6e0c13d0644cad6ddaa7ed0261a0b36971f6d23e7ec9b4b9097da78a10", size = 16674, upload-time = "2025-05-10T17:42:49.33Z" }, ] +[[package]] +name = "fastmcp" +version = "3.0.0rc2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "authlib" }, + { name = "cyclopts" }, + { name = "exceptiongroup" }, + { name = "httpx" }, + { name = "jsonref" }, + { name = "jsonschema-path" }, + { name = "mcp" }, + { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, + { name = "platformdirs" }, + { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, + { name = "pydantic", extra = ["email"] }, + { name = "pyperclip" }, + { name = "python-dotenv" }, + { name = "pyyaml" }, + { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, + { name = "websockets" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, +] + [[package]] name = "fonttools" version = "4.58.4" @@ -594,6 +819,18 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/76/c6/c88e154df9c4e1a2a66ccf0005a88dfb2650c1dffb6f5ce603dfbd452ce3/idna-3.10-py3-none-any.whl", hash = "sha256:946d195a0d259cbba61165e88e65941f16e9b36ea6ddb97f00452bae8b1287d3", size = 70442, upload-time = "2024-09-15T18:07:37.964Z" }, ] +[[package]] +name = "importlib-metadata" +version = "8.7.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "zipp" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/f3/49/3b30cad09e7771a4982d9975a8cbf64f00d4a1ececb53297f1d9a7be1b10/importlib_metadata-8.7.1.tar.gz", hash = "sha256:49fef1ae6440c182052f407c8d34a68f72efc36db9ca90dc0113398f2fdde8bb", size = 57107, upload-time = "2025-12-21T10:00:19.278Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/fa/5e/f8e9a1d23b9c20a551a8a02ea3637b4642e22c2626e3a13a9a29cdea99eb/importlib_metadata-8.7.1-py3-none-any.whl", hash = "sha256:5a1f80bf1daa489495071efbb095d75a634cf28a8bc299581244063b53176151", size = 27865, upload-time = "2025-12-21T10:00:18.329Z" }, +] + [[package]] name = "iniconfig" version = "2.1.0" @@ -603,6 +840,60 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/2c/e1/e6716421ea10d38022b952c159d5161ca1193197fb744506875fbb87ea7b/iniconfig-2.1.0-py3-none-any.whl", hash = "sha256:9deba5723312380e77435581c6bf4935c94cbfab9b1ed33ef8d238ea168eb760", size = 6050, upload-time = "2025-03-19T20:10:01.071Z" }, ] +[[package]] +name = "jaraco-classes" +version = "3.4.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "more-itertools" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/06/c0/ed4a27bc5571b99e3cff68f8a9fa5b56ff7df1c2251cc715a652ddd26402/jaraco.classes-3.4.0.tar.gz", hash = "sha256:47a024b51d0239c0dd8c8540c6c7f484be3b8fcf0b2d85c13825780d3b3f3acd", size = 11780, upload-time = "2024-03-31T07:27:36.643Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7f/66/b15ce62552d84bbfcec9a4873ab79d993a1dd4edb922cbfccae192bd5b5f/jaraco.classes-3.4.0-py3-none-any.whl", hash = "sha256:f662826b6bed8cace05e7ff873ce0f9283b5c924470fe664fff1c2f00f581790", size = 6777, upload-time = "2024-03-31T07:27:34.792Z" }, +] + +[[package]] +name = "jaraco-context" +version = "6.1.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "backports-tarfile", marker = "python_full_version < '3.12'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/cb/9c/a788f5bb29c61e456b8ee52ce76dbdd32fd72cd73dd67bc95f42c7a8d13c/jaraco_context-6.1.0.tar.gz", hash = "sha256:129a341b0a85a7db7879e22acd66902fda67882db771754574338898b2d5d86f", size = 15850, upload-time = "2026-01-13T02:53:53.847Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/8d/48/aa685dbf1024c7bd82bede569e3a85f82c32fd3d79ba5fea578f0159571a/jaraco_context-6.1.0-py3-none-any.whl", hash = "sha256:a43b5ed85815223d0d3cfdb6d7ca0d2bc8946f28f30b6f3216bda070f68badda", size = 7065, upload-time = "2026-01-13T02:53:53.031Z" }, +] + +[[package]] +name = "jaraco-functools" +version = "4.4.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "more-itertools" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/0f/27/056e0638a86749374d6f57d0b0db39f29509cce9313cf91bdc0ac4d91084/jaraco_functools-4.4.0.tar.gz", hash = "sha256:da21933b0417b89515562656547a77b4931f98176eb173644c0d35032a33d6bb", size = 19943, upload-time = "2025-12-21T09:29:43.6Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/fd/c4/813bb09f0985cb21e959f21f2464169eca882656849adf727ac7bb7e1767/jaraco_functools-4.4.0-py3-none-any.whl", hash = "sha256:9eec1e36f45c818d9bf307c8948eb03b2b56cd44087b3cdc989abca1f20b9176", size = 10481, upload-time = "2025-12-21T09:29:42.27Z" }, +] + +[[package]] +name = "jeepney" +version = "0.9.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7b/6f/357efd7602486741aa73ffc0617fb310a29b588ed0fd69c2399acbb85b0c/jeepney-0.9.0.tar.gz", hash = "sha256:cf0e9e845622b81e4a28df94c40345400256ec608d0e55bb8a3feaa9163f5732", size = 106758, upload-time = "2025-02-27T18:51:01.684Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, +] + +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -618,6 +909,21 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/bf/9c/8c95d856233c1f82500c2450b8c68576b4cf1c871db3afac5c34ff84e6fd/jsonschema-4.25.1-py3-none-any.whl", hash = "sha256:3fba0169e345c7175110351d456342c364814cfcf3b964ba4587f22915230a63", size = 90040, upload-time = "2025-08-18T17:03:48.373Z" }, ] +[[package]] +name = "jsonschema-path" +version = "0.3.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pathable" }, + { name = "pyyaml" }, + { name = "referencing" }, + { name = "requests" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/6e/45/41ebc679c2a4fced6a722f624c18d658dee42612b83ea24c1caf7c0eb3a8/jsonschema_path-0.3.4.tar.gz", hash = "sha256:8365356039f16cc65fddffafda5f58766e34bebab7d6d105616ab52bc4297001", size = 11159, upload-time = "2025-01-24T14:33:16.547Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cb/58/3485da8cb93d2f393bce453adeef16896751f14ba3e2024bc21dc9597646/jsonschema_path-0.3.4-py3-none-any.whl", hash = "sha256:f502191fdc2b22050f9a81c9237be9d27145b9001c55842bece5e94e382e52f8", size = 14810, upload-time = "2025-01-24T14:33:14.652Z" }, +] + [[package]] name = "jsonschema-specifications" version = "2025.9.1" @@ -630,6 +936,24 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" }, ] +[[package]] +name = "keyring" +version = "25.7.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata", marker = "python_full_version < '3.12'" }, + { name = "jaraco-classes" }, + { name = "jaraco-context" }, + { name = "jaraco-functools" }, + { name = "jeepney", marker = "sys_platform == 'linux'" }, + { name = "pywin32-ctypes", marker = "sys_platform == 'win32'" }, + { name = "secretstorage", marker = "sys_platform == 'linux'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/43/4b/674af6ef2f97d56f0ab5153bf0bfa28ccb6c3ed4d1babf4305449668807b/keyring-25.7.0.tar.gz", hash = "sha256:fe01bd85eb3f8fb3dd0405defdeac9a5b4f6f0439edbb3149577f244a2e8245b", size = 63516, upload-time = "2025-11-16T16:26:09.482Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/81/db/e655086b7f3a705df045bf0933bdd9c2f79bb3c97bfef1384598bb79a217/keyring-25.7.0-py3-none-any.whl", hash = "sha256:be4a0b195f149690c166e850609a477c532ddbfbaed96a404d4e43f8d5e2689f", size = 39160, upload-time = "2025-11-16T16:26:08.402Z" }, +] + [[package]] name = "kiwisolver" version = "1.4.8" @@ -784,7 +1108,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -798,17 +1122,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, -] - -[package.optional-dependencies] -cli = [ - { name = "python-dotenv" }, - { name = "typer" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -820,6 +1140,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" }, ] +[[package]] +name = "more-itertools" +version = "10.8.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/ea/5d/38b681d3fce7a266dd9ab73c66959406d565b3e85f21d5e66e1181d93721/more_itertools-10.8.0.tar.gz", hash = "sha256:f638ddf8a1a0d134181275fb5d58b086ead7c6a72429ad725c67503f13ba30bd", size = 137431, upload-time = "2025-09-02T15:23:11.018Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a4/8e/469e5a4a2f5855992e425f3cb33804cc07bf18d48f2db061aec61ce50270/more_itertools-10.8.0-py3-none-any.whl", hash = "sha256:52d4362373dcf7c52546bc4af9a86ee7c4579df9a8dc268be0a2f949d376cc9b", size = 69667, upload-time = "2025-09-02T15:23:09.635Z" }, +] + [[package]] name = "numpy" version = "2.2.6" @@ -947,6 +1276,31 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/48/6b/1c6b515a83d5564b1698a61efa245727c8feecf308f4091f565988519d20/numpy-2.3.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:e610832418a2bc09d974cc9fecebfa51e9532d6190223bc5ef6a7402ebf3b5cb", size = 12927246, upload-time = "2025-06-21T12:27:38.618Z" }, ] +[[package]] +name = "openapi-pydantic" +version = "0.5.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pydantic" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/02/2e/58d83848dd1a79cb92ed8e63f6ba901ca282c5f09d04af9423ec26c56fd7/openapi_pydantic-0.5.1.tar.gz", hash = "sha256:ff6835af6bde7a459fb93eb93bb92b8749b754fc6e51b2f1590a19dc3005ee0d", size = 60892, upload-time = "2025-01-08T19:29:27.083Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, +] + +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -1005,6 +1359,24 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/39/c2/646d2e93e0af70f4e5359d870a63584dacbc324b54d73e6b3267920ff117/pandas-2.3.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:bb3be958022198531eb7ec2008cfc78c5b1eed51af8600c6c5d9160d89d8d249", size = 13231847, upload-time = "2025-06-05T03:27:51.465Z" }, ] +[[package]] +name = "pathable" +version = "0.4.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/67/93/8f2c2075b180c12c1e9f6a09d1a985bc2036906b13dff1d8917e395f2048/pathable-0.4.4.tar.gz", hash = "sha256:6905a3cd17804edfac7875b5f6c9142a218c7caef78693c2dbbbfbac186d88b2", size = 8124, upload-time = "2025-01-10T18:43:13.247Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/7d/eb/b6260b31b1a96386c0a880edebe26f89669098acea8e0318bff6adb378fd/pathable-0.4.4-py3-none-any.whl", hash = "sha256:5ae9e94793b6ef5a4cbe0a7ce9dbbefc1eec38df253763fd0aeeacf2762dbbc2", size = 9592, upload-time = "2025-01-10T18:43:11.88Z" }, +] + +[[package]] +name = "pathvalidate" +version = "3.3.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/fa/2a/52a8da6fe965dea6192eb716b357558e103aea0a1e9a8352ad575a8406ca/pathvalidate-3.3.1.tar.gz", hash = "sha256:b18c07212bfead624345bb8e1d6141cdcf15a39736994ea0b94035ad2b1ba177", size = 63262, upload-time = "2025-06-15T09:07:20.736Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9a/70/875f4a23bfc4731703a5835487d0d2fb999031bd415e7d17c0ae615c18b7/pathvalidate-3.3.1-py3-none-any.whl", hash = "sha256:5263baab691f8e1af96092fa5137ee17df5bdfbd6cff1fcac4d6ef4bc2e1735f", size = 24305, upload-time = "2025-06-15T09:07:19.117Z" }, +] + [[package]] name = "pillow" version = "12.0.0" @@ -1103,6 +1475,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/95/7e/f896623c3c635a90537ac093c6a618ebe1a90d87206e42309cb5d98a1b9e/pillow-12.0.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:b290fd8aa38422444d4b50d579de197557f182ef1068b75f5aa8558638b8d0a5", size = 6997850, upload-time = "2025-10-15T18:24:11.495Z" }, ] +[[package]] +name = "platformdirs" +version = "4.9.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/1b/04/fea538adf7dbbd6d186f551d595961e564a3b6715bdf276b477460858672/platformdirs-4.9.2.tar.gz", hash = "sha256:9a33809944b9db043ad67ca0db94b14bf452cc6aeaac46a88ea55b26e2e9d291", size = 28394, upload-time = "2026-02-16T03:56:10.574Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/48/31/05e764397056194206169869b50cf2fee4dbbbc71b344705b9c0d878d4d8/platformdirs-4.9.2-py3-none-any.whl", hash = "sha256:9170634f126f8efdae22fb58ae8a0eaa86f38365bc57897a6c4f781d1f5875bd", size = 21168, upload-time = "2026-02-16T03:56:08.891Z" }, +] + [[package]] name = "pluggy" version = "1.6.0" @@ -1112,6 +1493,31 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" }, ] +[[package]] +name = "py-key-value-aio" +version = "0.4.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "beartype" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, +] + +[package.optional-dependencies] +disk = [ + { name = "diskcache" }, + { name = "pathvalidate" }, +] +keyring = [ + { name = "keyring" }, +] +memory = [ + { name = "cachetools" }, +] + [[package]] name = "pycparser" version = "2.23" @@ -1136,6 +1542,11 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/6a/c0/ec2b1c8712ca690e5d61979dee872603e92b8a32f94cc1b72d53beab008a/pydantic-2.11.7-py3-none-any.whl", hash = "sha256:dde5df002701f6de26248661f6835bbe296a47bf73990135c7d07ce741b9623b", size = 444782, upload-time = "2025-06-14T08:33:14.905Z" }, ] +[package.optional-dependencies] +email = [ + { name = "email-validator" }, +] + [[package]] name = "pydantic-core" version = "2.33.2" @@ -1269,6 +1680,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/05/e7/df2285f3d08fee213f2d041540fa4fc9ca6c2d44cf36d3a035bf2a8d2bcc/pyparsing-3.2.3-py3-none-any.whl", hash = "sha256:a749938e02d6fd0b59b356ca504a24982314bb090c383e3cf201c95ef7e2bfcf", size = 111120, upload-time = "2025-03-25T05:01:24.908Z" }, ] +[[package]] +name = "pyperclip" +version = "1.11.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e8/52/d87eba7cb129b81563019d1679026e7a112ef76855d6159d24754dbd2a51/pyperclip-1.11.0.tar.gz", hash = "sha256:244035963e4428530d9e3a6101a1ef97209c6825edab1567beac148ccc1db1b6", size = 12185, upload-time = "2025-09-26T14:40:37.245Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/df/80/fc9d01d5ed37ba4c42ca2b55b4339ae6e200b456be3a1aaddf4a9fa99b8c/pyperclip-1.11.0-py3-none-any.whl", hash = "sha256:299403e9ff44581cb9ba2ffeed69c7aa96a008622ad0c46cb575ca75b5b84273", size = 11063, upload-time = "2025-09-26T14:40:36.069Z" }, +] + [[package]] name = "pytest" version = "8.4.1" @@ -1374,18 +1794,106 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" }, ] +[[package]] +name = "pywin32-ctypes" +version = "0.2.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/85/9f/01a1a99704853cb63f253eea009390c88e7131c67e66a0a02099a8c917cb/pywin32-ctypes-0.2.3.tar.gz", hash = "sha256:d162dc04946d704503b2edc4d55f3dba5c1d539ead017afa00142c38b9885755", size = 29471, upload-time = "2024-08-14T10:15:34.626Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/de/3d/8161f7711c017e01ac9f008dfddd9410dff3674334c233bde66e7ba65bbf/pywin32_ctypes-0.2.3-py3-none-any.whl", hash = "sha256:8a1513379d709975552d202d942d9837758905c8d01eb82b8bcc30918929e7b8", size = 30756, upload-time = "2024-08-14T10:15:33.187Z" }, +] + +[[package]] +name = "pyyaml" +version = "6.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f4/a0/39350dd17dd6d6c6507025c0e53aef67a9293a6d37d3511f23ea510d5800/pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b", size = 184227, upload-time = "2025-09-25T21:31:46.04Z" }, + { url = "https://files.pythonhosted.org/packages/05/14/52d505b5c59ce73244f59c7a50ecf47093ce4765f116cdb98286a71eeca2/pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956", size = 174019, upload-time = "2025-09-25T21:31:47.706Z" }, + { url = "https://files.pythonhosted.org/packages/43/f7/0e6a5ae5599c838c696adb4e6330a59f463265bfa1e116cfd1fbb0abaaae/pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8", size = 740646, upload-time = "2025-09-25T21:31:49.21Z" }, + { url = "https://files.pythonhosted.org/packages/2f/3a/61b9db1d28f00f8fd0ae760459a5c4bf1b941baf714e207b6eb0657d2578/pyyaml-6.0.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198", size = 840793, upload-time = "2025-09-25T21:31:50.735Z" }, + { url = "https://files.pythonhosted.org/packages/7a/1e/7acc4f0e74c4b3d9531e24739e0ab832a5edf40e64fbae1a9c01941cabd7/pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b", size = 770293, upload-time = "2025-09-25T21:31:51.828Z" }, + { url = "https://files.pythonhosted.org/packages/8b/ef/abd085f06853af0cd59fa5f913d61a8eab65d7639ff2a658d18a25d6a89d/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0", size = 732872, upload-time = "2025-09-25T21:31:53.282Z" }, + { url = "https://files.pythonhosted.org/packages/1f/15/2bc9c8faf6450a8b3c9fc5448ed869c599c0a74ba2669772b1f3a0040180/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69", size = 758828, upload-time = "2025-09-25T21:31:54.807Z" }, + { url = "https://files.pythonhosted.org/packages/a3/00/531e92e88c00f4333ce359e50c19b8d1de9fe8d581b1534e35ccfbc5f393/pyyaml-6.0.3-cp310-cp310-win32.whl", hash = "sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e", size = 142415, upload-time = "2025-09-25T21:31:55.885Z" }, + { url = "https://files.pythonhosted.org/packages/2a/fa/926c003379b19fca39dd4634818b00dec6c62d87faf628d1394e137354d4/pyyaml-6.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c", size = 158561, upload-time = "2025-09-25T21:31:57.406Z" }, + { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" }, + { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" }, + { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" }, + { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" }, + { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" }, + { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" }, + { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" }, + { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" }, + { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" }, + { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" }, + { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" }, + { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" }, + { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" }, + { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" }, + { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" }, + { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" }, + { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" }, + { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" }, + { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" }, + { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" }, + { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" }, + { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" }, + { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" }, + { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" }, + { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" }, + { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" }, + { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" }, + { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" }, + { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" }, + { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" }, + { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" }, + { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" }, + { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" }, + { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" }, + { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" }, + { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" }, + { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" }, + { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" }, + { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" }, + { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" }, + { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" }, + { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" }, + { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" }, + { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" }, + { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" }, + { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" }, + { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" }, +] + [[package]] name = "referencing" -version = "0.37.0" +version = "0.36.2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, { name = "rpds-py" }, { name = "typing-extensions", marker = "python_full_version < '3.13'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" } +sdist = { url = "https://files.pythonhosted.org/packages/2f/db/98b5c277be99dd18bfd91dd04e1b759cad18d1a338188c936e92f921c7e2/referencing-0.36.2.tar.gz", hash = "sha256:df2e89862cd09deabbdba16944cc3f10feb6b3e6f18e902f7cc25609a34775aa", size = 74744, upload-time = "2025-01-25T08:48:16.138Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" }, + { url = "https://files.pythonhosted.org/packages/c1/b1/3baf80dc6d2b7bc27a95a67752d0208e410351e3feb4eb78de5f77454d8d/referencing-0.36.2-py3-none-any.whl", hash = "sha256:e8699adbbf8b5c7de96d8ffa0eb5c158b3beafce084968e2ea8bb08c6794dcd0", size = 26775, upload-time = "2025-01-25T08:48:14.241Z" }, +] + +[[package]] +name = "requests" +version = "2.32.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "certifi" }, + { name = "charset-normalizer" }, + { name = "idna" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" }, ] [[package]] @@ -1402,6 +1910,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/0d/9b/63f4c7ebc259242c89b3acafdb37b41d1185c07ff0011164674e9076b491/rich-14.0.0-py3-none-any.whl", hash = "sha256:1c9491e1951aac09caffd42f448ee3d04e58923ffe14993f6e83068dc395d7e0", size = 243229, upload-time = "2025-03-30T14:15:12.283Z" }, ] +[[package]] +name = "rich-rst" +version = "1.3.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "docutils" }, + { name = "rich" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/bc/6d/a506aaa4a9eaa945ed8ab2b7347859f53593864289853c5d6d62b77246e0/rich_rst-1.3.2.tar.gz", hash = "sha256:a1196fdddf1e364b02ec68a05e8ff8f6914fee10fbca2e6b6735f166bb0da8d4", size = 14936, upload-time = "2025-10-14T16:49:45.332Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/13/2f/b4530fbf948867702d0a3f27de4a6aab1d156f406d72852ab902c4d04de9/rich_rst-1.3.2-py3-none-any.whl", hash = "sha256:a99b4907cbe118cf9d18b0b44de272efa61f15117c61e39ebdc431baf5df722a", size = 12567, upload-time = "2025-10-14T16:49:42.953Z" }, +] + [[package]] name = "rpds-py" version = "0.28.0" @@ -1676,12 +2197,16 @@ wheels = [ ] [[package]] -name = "shellingham" -version = "1.5.4" +name = "secretstorage" +version = "3.5.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" } +dependencies = [ + { name = "cryptography" }, + { name = "jeepney" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/1c/03/e834bcd866f2f8a49a85eaff47340affa3bfa391ee9912a952a1faa68c7b/secretstorage-3.5.0.tar.gz", hash = "sha256:f04b8e4689cbce351744d5537bf6b1329c6fc68f91fa666f60a380edddcd11be", size = 19884, upload-time = "2025-11-23T19:02:53.191Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" }, + { url = "https://files.pythonhosted.org/packages/b7/46/f5af3402b579fd5e11573ce652019a67074317e18c1935cc0b4ba9b35552/secretstorage-3.5.0-py3-none-any.whl", hash = "sha256:0ce65888c0725fcb2c5bc0fdb8e5438eece02c523557ea40ce0703c266248137", size = 15554, upload-time = "2025-11-23T19:02:51.545Z" }, ] [[package]] @@ -1766,28 +2291,13 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/6e/c2/61d3e0f47e2b74ef40a68b9e6ad5984f6241a942f7cd3bbfbdbd03861ea9/tomli-2.2.1-py3-none-any.whl", hash = "sha256:cb55c73c5f4408779d0cf3eef9f762b9c9f147a77de7b258bef0a5628adc85cc", size = 14257, upload-time = "2024-11-27T22:38:35.385Z" }, ] -[[package]] -name = "typer" -version = "0.16.0" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "click" }, - { name = "rich" }, - { name = "shellingham" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/c5/8c/7d682431efca5fd290017663ea4588bf6f2c6aad085c7f108c5dbc316e70/typer-0.16.0.tar.gz", hash = "sha256:af377ffaee1dbe37ae9440cb4e8f11686ea5ce4e9bae01b84ae7c63b87f1dd3b", size = 102625, upload-time = "2025-05-26T14:30:31.824Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/76/42/3efaf858001d2c2913de7f354563e3a3a2f0decae3efe98427125a8f441e/typer-0.16.0-py3-none-any.whl", hash = "sha256:1f79bed11d4d02d4310e3c1b7ba594183bcedb0ac73b27a9e5f28f6fb5b98855", size = 46317, upload-time = "2025-05-26T14:30:30.523Z" }, -] - [[package]] name = "typing-extensions" -version = "4.14.0" +version = "4.15.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/d1/bc/51647cd02527e87d05cb083ccc402f93e441606ff1f01739a62c8ad09ba5/typing_extensions-4.14.0.tar.gz", hash = "sha256:8676b788e32f02ab42d9e7c61324048ae4c6d844a399eebace3d4979d75ceef4", size = 107423, upload-time = "2025-06-02T14:52:11.399Z" } +sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/69/e0/552843e0d356fbb5256d21449fa957fa4eff3bbc135a74a691ee70c7c5da/typing_extensions-4.14.0-py3-none-any.whl", hash = "sha256:a1514509136dd0b477638fc68d6a91497af5076466ad0fa6c338e44e359944af", size = 43839, upload-time = "2025-06-02T14:52:10.026Z" }, + { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" }, ] [[package]] @@ -1811,16 +2321,205 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/5c/23/c7abc0ca0a1526a0774eca151daeb8de62ec457e77262b66b359c3c7679e/tzdata-2025.2-py2.py3-none-any.whl", hash = "sha256:1a403fada01ff9221ca8044d701868fa132215d84beb92242d9acd2147f667a8", size = 347839, upload-time = "2025-03-23T13:54:41.845Z" }, ] +[[package]] +name = "urllib3" +version = "2.6.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" }, +] + [[package]] name = "uvicorn" -version = "0.34.3" +version = "0.41.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "click" }, { name = "h11" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/de/ad/713be230bcda622eaa35c28f0d328c3675c371238470abdea52417f17a8e/uvicorn-0.34.3.tar.gz", hash = "sha256:35919a9a979d7a59334b6b10e05d77c1d0d574c50e0fc98b8b1a0f165708b55a", size = 76631, upload-time = "2025-06-01T07:48:17.531Z" } +sdist = { url = "https://files.pythonhosted.org/packages/32/ce/eeb58ae4ac36fe09e3842eb02e0eb676bf2c53ae062b98f1b2531673efdd/uvicorn-0.41.0.tar.gz", hash = "sha256:09d11cf7008da33113824ee5a1c6422d89fbc2ff476540d69a34c87fab8b571a", size = 82633, upload-time = "2026-02-16T23:07:24.1Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/6d/0d/8adfeaa62945f90d19ddc461c55f4a50c258af7662d34b6a3d5d1f8646f6/uvicorn-0.34.3-py3-none-any.whl", hash = "sha256:16246631db62bdfbf069b0645177d6e8a77ba950cfedbfd093acef9444e4d885", size = 62431, upload-time = "2025-06-01T07:48:15.664Z" }, + { url = "https://files.pythonhosted.org/packages/83/e4/d04a086285c20886c0daad0e026f250869201013d18f81d9ff5eada73a88/uvicorn-0.41.0-py3-none-any.whl", hash = "sha256:29e35b1d2c36a04b9e180d4007ede3bcb32a85fbdfd6c6aeb3f26839de088187", size = 68783, upload-time = "2026-02-16T23:07:22.357Z" }, +] + +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + +[[package]] +name = "websockets" +version = "16.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/04/24/4b2031d72e840ce4c1ccb255f693b15c334757fc50023e4db9537080b8c4/websockets-16.0.tar.gz", hash = "sha256:5f6261a5e56e8d5c42a4497b364ea24d94d9563e8fbd44e78ac40879c60179b5", size = 179346, upload-time = "2026-01-10T09:23:47.181Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/20/74/221f58decd852f4b59cc3354cccaf87e8ef695fede361d03dc9a7396573b/websockets-16.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:04cdd5d2d1dacbad0a7bf36ccbcd3ccd5a30ee188f2560b7a62a30d14107b31a", size = 177343, upload-time = "2026-01-10T09:22:21.28Z" }, + { url = "https://files.pythonhosted.org/packages/19/0f/22ef6107ee52ab7f0b710d55d36f5a5d3ef19e8a205541a6d7ffa7994e5a/websockets-16.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:8ff32bb86522a9e5e31439a58addbb0166f0204d64066fb955265c4e214160f0", size = 175021, upload-time = "2026-01-10T09:22:22.696Z" }, + { url = "https://files.pythonhosted.org/packages/10/40/904a4cb30d9b61c0e278899bf36342e9b0208eb3c470324a9ecbaac2a30f/websockets-16.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:583b7c42688636f930688d712885cf1531326ee05effd982028212ccc13e5957", size = 175320, upload-time = "2026-01-10T09:22:23.94Z" }, + { url = "https://files.pythonhosted.org/packages/9d/2f/4b3ca7e106bc608744b1cdae041e005e446124bebb037b18799c2d356864/websockets-16.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:7d837379b647c0c4c2355c2499723f82f1635fd2c26510e1f587d89bc2199e72", size = 183815, upload-time = "2026-01-10T09:22:25.469Z" }, + { url = "https://files.pythonhosted.org/packages/86/26/d40eaa2a46d4302becec8d15b0fc5e45bdde05191e7628405a19cf491ccd/websockets-16.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:df57afc692e517a85e65b72e165356ed1df12386ecb879ad5693be08fac65dde", size = 185054, upload-time = "2026-01-10T09:22:27.101Z" }, + { url = "https://files.pythonhosted.org/packages/b0/ba/6500a0efc94f7373ee8fefa8c271acdfd4dca8bd49a90d4be7ccabfc397e/websockets-16.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:2b9f1e0d69bc60a4a87349d50c09a037a2607918746f07de04df9e43252c77a3", size = 184565, upload-time = "2026-01-10T09:22:28.293Z" }, + { url = "https://files.pythonhosted.org/packages/04/b4/96bf2cee7c8d8102389374a2616200574f5f01128d1082f44102140344cc/websockets-16.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:335c23addf3d5e6a8633f9f8eda77efad001671e80b95c491dd0924587ece0b3", size = 183848, upload-time = "2026-01-10T09:22:30.394Z" }, + { url = "https://files.pythonhosted.org/packages/02/8e/81f40fb00fd125357814e8c3025738fc4ffc3da4b6b4a4472a82ba304b41/websockets-16.0-cp310-cp310-win32.whl", hash = "sha256:37b31c1623c6605e4c00d466c9d633f9b812ea430c11c8a278774a1fde1acfa9", size = 178249, upload-time = "2026-01-10T09:22:32.083Z" }, + { url = "https://files.pythonhosted.org/packages/b4/5f/7e40efe8df57db9b91c88a43690ac66f7b7aa73a11aa6a66b927e44f26fa/websockets-16.0-cp310-cp310-win_amd64.whl", hash = "sha256:8e1dab317b6e77424356e11e99a432b7cb2f3ec8c5ab4dabbcee6add48f72b35", size = 178685, upload-time = "2026-01-10T09:22:33.345Z" }, + { url = "https://files.pythonhosted.org/packages/f2/db/de907251b4ff46ae804ad0409809504153b3f30984daf82a1d84a9875830/websockets-16.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:31a52addea25187bde0797a97d6fc3d2f92b6f72a9370792d65a6e84615ac8a8", size = 177340, upload-time = "2026-01-10T09:22:34.539Z" }, + { url = "https://files.pythonhosted.org/packages/f3/fa/abe89019d8d8815c8781e90d697dec52523fb8ebe308bf11664e8de1877e/websockets-16.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:417b28978cdccab24f46400586d128366313e8a96312e4b9362a4af504f3bbad", size = 175022, upload-time = "2026-01-10T09:22:36.332Z" }, + { url = "https://files.pythonhosted.org/packages/58/5d/88ea17ed1ded2079358b40d31d48abe90a73c9e5819dbcde1606e991e2ad/websockets-16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:af80d74d4edfa3cb9ed973a0a5ba2b2a549371f8a741e0800cb07becdd20f23d", size = 175319, upload-time = "2026-01-10T09:22:37.602Z" }, + { url = "https://files.pythonhosted.org/packages/d2/ae/0ee92b33087a33632f37a635e11e1d99d429d3d323329675a6022312aac2/websockets-16.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:08d7af67b64d29823fed316505a89b86705f2b7981c07848fb5e3ea3020c1abe", size = 184631, upload-time = "2026-01-10T09:22:38.789Z" }, + { url = "https://files.pythonhosted.org/packages/c8/c5/27178df583b6c5b31b29f526ba2da5e2f864ecc79c99dae630a85d68c304/websockets-16.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7be95cfb0a4dae143eaed2bcba8ac23f4892d8971311f1b06f3c6b78952ee70b", size = 185870, upload-time = "2026-01-10T09:22:39.893Z" }, + { url = "https://files.pythonhosted.org/packages/87/05/536652aa84ddc1c018dbb7e2c4cbcd0db884580bf8e95aece7593fde526f/websockets-16.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d6297ce39ce5c2e6feb13c1a996a2ded3b6832155fcfc920265c76f24c7cceb5", size = 185361, upload-time = "2026-01-10T09:22:41.016Z" }, + { url = "https://files.pythonhosted.org/packages/6d/e2/d5332c90da12b1e01f06fb1b85c50cfc489783076547415bf9f0a659ec19/websockets-16.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:1c1b30e4f497b0b354057f3467f56244c603a79c0d1dafce1d16c283c25f6e64", size = 184615, upload-time = "2026-01-10T09:22:42.442Z" }, + { url = "https://files.pythonhosted.org/packages/77/fb/d3f9576691cae9253b51555f841bc6600bf0a983a461c79500ace5a5b364/websockets-16.0-cp311-cp311-win32.whl", hash = "sha256:5f451484aeb5cafee1ccf789b1b66f535409d038c56966d6101740c1614b86c6", size = 178246, upload-time = "2026-01-10T09:22:43.654Z" }, + { url = "https://files.pythonhosted.org/packages/54/67/eaff76b3dbaf18dcddabc3b8c1dba50b483761cccff67793897945b37408/websockets-16.0-cp311-cp311-win_amd64.whl", hash = "sha256:8d7f0659570eefb578dacde98e24fb60af35350193e4f56e11190787bee77dac", size = 178684, upload-time = "2026-01-10T09:22:44.941Z" }, + { url = "https://files.pythonhosted.org/packages/84/7b/bac442e6b96c9d25092695578dda82403c77936104b5682307bd4deb1ad4/websockets-16.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:71c989cbf3254fbd5e84d3bff31e4da39c43f884e64f2551d14bb3c186230f00", size = 177365, upload-time = "2026-01-10T09:22:46.787Z" }, + { url = "https://files.pythonhosted.org/packages/b0/fe/136ccece61bd690d9c1f715baaeefd953bb2360134de73519d5df19d29ca/websockets-16.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8b6e209ffee39ff1b6d0fa7bfef6de950c60dfb91b8fcead17da4ee539121a79", size = 175038, upload-time = "2026-01-10T09:22:47.999Z" }, + { url = "https://files.pythonhosted.org/packages/40/1e/9771421ac2286eaab95b8575b0cb701ae3663abf8b5e1f64f1fd90d0a673/websockets-16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:86890e837d61574c92a97496d590968b23c2ef0aeb8a9bc9421d174cd378ae39", size = 175328, upload-time = "2026-01-10T09:22:49.809Z" }, + { url = "https://files.pythonhosted.org/packages/18/29/71729b4671f21e1eaa5d6573031ab810ad2936c8175f03f97f3ff164c802/websockets-16.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:9b5aca38b67492ef518a8ab76851862488a478602229112c4b0d58d63a7a4d5c", size = 184915, upload-time = "2026-01-10T09:22:51.071Z" }, + { url = "https://files.pythonhosted.org/packages/97/bb/21c36b7dbbafc85d2d480cd65df02a1dc93bf76d97147605a8e27ff9409d/websockets-16.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e0334872c0a37b606418ac52f6ab9cfd17317ac26365f7f65e203e2d0d0d359f", size = 186152, upload-time = "2026-01-10T09:22:52.224Z" }, + { url = "https://files.pythonhosted.org/packages/4a/34/9bf8df0c0cf88fa7bfe36678dc7b02970c9a7d5e065a3099292db87b1be2/websockets-16.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a0b31e0b424cc6b5a04b8838bbaec1688834b2383256688cf47eb97412531da1", size = 185583, upload-time = "2026-01-10T09:22:53.443Z" }, + { url = "https://files.pythonhosted.org/packages/47/88/4dd516068e1a3d6ab3c7c183288404cd424a9a02d585efbac226cb61ff2d/websockets-16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:485c49116d0af10ac698623c513c1cc01c9446c058a4e61e3bf6c19dff7335a2", size = 184880, upload-time = "2026-01-10T09:22:55.033Z" }, + { url = "https://files.pythonhosted.org/packages/91/d6/7d4553ad4bf1c0421e1ebd4b18de5d9098383b5caa1d937b63df8d04b565/websockets-16.0-cp312-cp312-win32.whl", hash = "sha256:eaded469f5e5b7294e2bdca0ab06becb6756ea86894a47806456089298813c89", size = 178261, upload-time = "2026-01-10T09:22:56.251Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f0/f3a17365441ed1c27f850a80b2bc680a0fa9505d733fe152fdf5e98c1c0b/websockets-16.0-cp312-cp312-win_amd64.whl", hash = "sha256:5569417dc80977fc8c2d43a86f78e0a5a22fee17565d78621b6bb264a115d4ea", size = 178693, upload-time = "2026-01-10T09:22:57.478Z" }, + { url = "https://files.pythonhosted.org/packages/cc/9c/baa8456050d1c1b08dd0ec7346026668cbc6f145ab4e314d707bb845bf0d/websockets-16.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:878b336ac47938b474c8f982ac2f7266a540adc3fa4ad74ae96fea9823a02cc9", size = 177364, upload-time = "2026-01-10T09:22:59.333Z" }, + { url = "https://files.pythonhosted.org/packages/7e/0c/8811fc53e9bcff68fe7de2bcbe75116a8d959ac699a3200f4847a8925210/websockets-16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:52a0fec0e6c8d9a784c2c78276a48a2bdf099e4ccc2a4cad53b27718dbfd0230", size = 175039, upload-time = "2026-01-10T09:23:01.171Z" }, + { url = "https://files.pythonhosted.org/packages/aa/82/39a5f910cb99ec0b59e482971238c845af9220d3ab9fa76dd9162cda9d62/websockets-16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6578ed5b6981005df1860a56e3617f14a6c307e6a71b4fff8c48fdc50f3ed2c", size = 175323, upload-time = "2026-01-10T09:23:02.341Z" }, + { url = "https://files.pythonhosted.org/packages/bd/28/0a25ee5342eb5d5f297d992a77e56892ecb65e7854c7898fb7d35e9b33bd/websockets-16.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:95724e638f0f9c350bb1c2b0a7ad0e83d9cc0c9259f3ea94e40d7b02a2179ae5", size = 184975, upload-time = "2026-01-10T09:23:03.756Z" }, + { url = "https://files.pythonhosted.org/packages/f9/66/27ea52741752f5107c2e41fda05e8395a682a1e11c4e592a809a90c6a506/websockets-16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0204dc62a89dc9d50d682412c10b3542d748260d743500a85c13cd1ee4bde82", size = 186203, upload-time = "2026-01-10T09:23:05.01Z" }, + { url = "https://files.pythonhosted.org/packages/37/e5/8e32857371406a757816a2b471939d51c463509be73fa538216ea52b792a/websockets-16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:52ac480f44d32970d66763115edea932f1c5b1312de36df06d6b219f6741eed8", size = 185653, upload-time = "2026-01-10T09:23:06.301Z" }, + { url = "https://files.pythonhosted.org/packages/9b/67/f926bac29882894669368dc73f4da900fcdf47955d0a0185d60103df5737/websockets-16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6e5a82b677f8f6f59e8dfc34ec06ca6b5b48bc4fcda346acd093694cc2c24d8f", size = 184920, upload-time = "2026-01-10T09:23:07.492Z" }, + { url = "https://files.pythonhosted.org/packages/3c/a1/3d6ccdcd125b0a42a311bcd15a7f705d688f73b2a22d8cf1c0875d35d34a/websockets-16.0-cp313-cp313-win32.whl", hash = "sha256:abf050a199613f64c886ea10f38b47770a65154dc37181bfaff70c160f45315a", size = 178255, upload-time = "2026-01-10T09:23:09.245Z" }, + { url = "https://files.pythonhosted.org/packages/6b/ae/90366304d7c2ce80f9b826096a9e9048b4bb760e44d3b873bb272cba696b/websockets-16.0-cp313-cp313-win_amd64.whl", hash = "sha256:3425ac5cf448801335d6fdc7ae1eb22072055417a96cc6b31b3861f455fbc156", size = 178689, upload-time = "2026-01-10T09:23:10.483Z" }, + { url = "https://files.pythonhosted.org/packages/f3/1d/e88022630271f5bd349ed82417136281931e558d628dd52c4d8621b4a0b2/websockets-16.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8cc451a50f2aee53042ac52d2d053d08bf89bcb31ae799cb4487587661c038a0", size = 177406, upload-time = "2026-01-10T09:23:12.178Z" }, + { url = "https://files.pythonhosted.org/packages/f2/78/e63be1bf0724eeb4616efb1ae1c9044f7c3953b7957799abb5915bffd38e/websockets-16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:daa3b6ff70a9241cf6c7fc9e949d41232d9d7d26fd3522b1ad2b4d62487e9904", size = 175085, upload-time = "2026-01-10T09:23:13.511Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/d3c9220d818ee955ae390cf319a7c7a467beceb24f05ee7aaaa2414345ba/websockets-16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fd3cb4adb94a2a6e2b7c0d8d05cb94e6f1c81a0cf9dc2694fb65c7e8d94c42e4", size = 175328, upload-time = "2026-01-10T09:23:14.727Z" }, + { url = "https://files.pythonhosted.org/packages/63/bc/d3e208028de777087e6fb2b122051a6ff7bbcca0d6df9d9c2bf1dd869ae9/websockets-16.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:781caf5e8eee67f663126490c2f96f40906594cb86b408a703630f95550a8c3e", size = 185044, upload-time = "2026-01-10T09:23:15.939Z" }, + { url = "https://files.pythonhosted.org/packages/ad/6e/9a0927ac24bd33a0a9af834d89e0abc7cfd8e13bed17a86407a66773cc0e/websockets-16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:caab51a72c51973ca21fa8a18bd8165e1a0183f1ac7066a182ff27107b71e1a4", size = 186279, upload-time = "2026-01-10T09:23:17.148Z" }, + { url = "https://files.pythonhosted.org/packages/b9/ca/bf1c68440d7a868180e11be653c85959502efd3a709323230314fda6e0b3/websockets-16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19c4dc84098e523fd63711e563077d39e90ec6702aff4b5d9e344a60cb3c0cb1", size = 185711, upload-time = "2026-01-10T09:23:18.372Z" }, + { url = "https://files.pythonhosted.org/packages/c4/f8/fdc34643a989561f217bb477cbc47a3a07212cbda91c0e4389c43c296ebf/websockets-16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5e18a238a2b2249c9a9235466b90e96ae4795672598a58772dd806edc7ac6d3", size = 184982, upload-time = "2026-01-10T09:23:19.652Z" }, + { url = "https://files.pythonhosted.org/packages/dd/d1/574fa27e233764dbac9c52730d63fcf2823b16f0856b3329fc6268d6ae4f/websockets-16.0-cp314-cp314-win32.whl", hash = "sha256:a069d734c4a043182729edd3e9f247c3b2a4035415a9172fd0f1b71658a320a8", size = 177915, upload-time = "2026-01-10T09:23:21.458Z" }, + { url = "https://files.pythonhosted.org/packages/8a/f1/ae6b937bf3126b5134ce1f482365fde31a357c784ac51852978768b5eff4/websockets-16.0-cp314-cp314-win_amd64.whl", hash = "sha256:c0ee0e63f23914732c6d7e0cce24915c48f3f1512ec1d079ed01fc629dab269d", size = 178381, upload-time = "2026-01-10T09:23:22.715Z" }, + { url = "https://files.pythonhosted.org/packages/06/9b/f791d1db48403e1f0a27577a6beb37afae94254a8c6f08be4a23e4930bc0/websockets-16.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:a35539cacc3febb22b8f4d4a99cc79b104226a756aa7400adc722e83b0d03244", size = 177737, upload-time = "2026-01-10T09:23:24.523Z" }, + { url = "https://files.pythonhosted.org/packages/bd/40/53ad02341fa33b3ce489023f635367a4ac98b73570102ad2cdd770dacc9a/websockets-16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b784ca5de850f4ce93ec85d3269d24d4c82f22b7212023c974c401d4980ebc5e", size = 175268, upload-time = "2026-01-10T09:23:25.781Z" }, + { url = "https://files.pythonhosted.org/packages/74/9b/6158d4e459b984f949dcbbb0c5d270154c7618e11c01029b9bbd1bb4c4f9/websockets-16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:569d01a4e7fba956c5ae4fc988f0d4e187900f5497ce46339c996dbf24f17641", size = 175486, upload-time = "2026-01-10T09:23:27.033Z" }, + { url = "https://files.pythonhosted.org/packages/e5/2d/7583b30208b639c8090206f95073646c2c9ffd66f44df967981a64f849ad/websockets-16.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50f23cdd8343b984957e4077839841146f67a3d31ab0d00e6b824e74c5b2f6e8", size = 185331, upload-time = "2026-01-10T09:23:28.259Z" }, + { url = "https://files.pythonhosted.org/packages/45/b0/cce3784eb519b7b5ad680d14b9673a31ab8dcb7aad8b64d81709d2430aa8/websockets-16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:152284a83a00c59b759697b7f9e9cddf4e3c7861dd0d964b472b70f78f89e80e", size = 186501, upload-time = "2026-01-10T09:23:29.449Z" }, + { url = "https://files.pythonhosted.org/packages/19/60/b8ebe4c7e89fb5f6cdf080623c9d92789a53636950f7abacfc33fe2b3135/websockets-16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:bc59589ab64b0022385f429b94697348a6a234e8ce22544e3681b2e9331b5944", size = 186062, upload-time = "2026-01-10T09:23:31.368Z" }, + { url = "https://files.pythonhosted.org/packages/88/a8/a080593f89b0138b6cba1b28f8df5673b5506f72879322288b031337c0b8/websockets-16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:32da954ffa2814258030e5a57bc73a3635463238e797c7375dc8091327434206", size = 185356, upload-time = "2026-01-10T09:23:32.627Z" }, + { url = "https://files.pythonhosted.org/packages/c2/b6/b9afed2afadddaf5ebb2afa801abf4b0868f42f8539bfe4b071b5266c9fe/websockets-16.0-cp314-cp314t-win32.whl", hash = "sha256:5a4b4cc550cb665dd8a47f868c8d04c8230f857363ad3c9caf7a0c3bf8c61ca6", size = 178085, upload-time = "2026-01-10T09:23:33.816Z" }, + { url = "https://files.pythonhosted.org/packages/9f/3e/28135a24e384493fa804216b79a6a6759a38cc4ff59118787b9fb693df93/websockets-16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b14dc141ed6d2dde437cddb216004bcac6a1df0935d79656387bd41632ba0bbd", size = 178531, upload-time = "2026-01-10T09:23:35.016Z" }, + { url = "https://files.pythonhosted.org/packages/72/07/c98a68571dcf256e74f1f816b8cc5eae6eb2d3d5cfa44d37f801619d9166/websockets-16.0-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:349f83cd6c9a415428ee1005cadb5c2c56f4389bc06a9af16103c3bc3dcc8b7d", size = 174947, upload-time = "2026-01-10T09:23:36.166Z" }, + { url = "https://files.pythonhosted.org/packages/7e/52/93e166a81e0305b33fe416338be92ae863563fe7bce446b0f687b9df5aea/websockets-16.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:4a1aba3340a8dca8db6eb5a7986157f52eb9e436b74813764241981ca4888f03", size = 175260, upload-time = "2026-01-10T09:23:37.409Z" }, + { url = "https://files.pythonhosted.org/packages/56/0c/2dbf513bafd24889d33de2ff0368190a0e69f37bcfa19009ef819fe4d507/websockets-16.0-pp311-pypy311_pp73-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:f4a32d1bd841d4bcbffdcb3d2ce50c09c3909fbead375ab28d0181af89fd04da", size = 176071, upload-time = "2026-01-10T09:23:39.158Z" }, + { url = "https://files.pythonhosted.org/packages/a5/8f/aea9c71cc92bf9b6cc0f7f70df8f0b420636b6c96ef4feee1e16f80f75dd/websockets-16.0-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0298d07ee155e2e9fda5be8a9042200dd2e3bb0b8a38482156576f863a9d457c", size = 176968, upload-time = "2026-01-10T09:23:41.031Z" }, + { url = "https://files.pythonhosted.org/packages/9a/3f/f70e03f40ffc9a30d817eef7da1be72ee4956ba8d7255c399a01b135902a/websockets-16.0-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:a653aea902e0324b52f1613332ddf50b00c06fdaf7e92624fbf8c77c78fa5767", size = 178735, upload-time = "2026-01-10T09:23:42.259Z" }, + { url = "https://files.pythonhosted.org/packages/6f/28/258ebab549c2bf3e64d2b0217b973467394a9cea8c42f70418ca2c5d0d2e/websockets-16.0-py3-none-any.whl", hash = "sha256:1637db62fad1dc833276dded54215f2c7fa46912301a24bd94d45d46a011ceec", size = 171598, upload-time = "2026-01-10T09:23:45.395Z" }, +] + +[[package]] +name = "zipp" +version = "3.23.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/e3/02/0f2892c661036d50ede074e376733dca2ae7c6eb617489437771209d4180/zipp-3.23.0.tar.gz", hash = "sha256:a07157588a12518c9d4034df3fbbee09c814741a33ff63c05fa29d26a2404166", size = 25547, upload-time = "2025-06-08T17:06:39.4Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2e/54/647ade08bf0db230bfea292f893923872fd20be6ac6f53b2b936ba839d75/zipp-3.23.0-py3-none-any.whl", hash = "sha256:071652d6115ed432f5ce1d34c336c0adfd6a884660d1e9712a256d3d3bd4b14e", size = 10276, upload-time = "2025-06-08T17:06:38.034Z" }, ] diff --git a/clio-kit-mcp-servers/hdf5/.claude-plugin/plugin.json b/clio-kit-mcp-servers/hdf5/.claude-plugin/plugin.json new file mode 100644 index 00000000..a667d715 --- /dev/null +++ b/clio-kit-mcp-servers/hdf5/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-hdf5", + "description": "HDF5 FastMCP - Scientific Data Access for AI Agents | CLIO Kit MCP Server", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/hdf5/.mcp.json b/clio-kit-mcp-servers/hdf5/.mcp.json new file mode 100644 index 00000000..29b2eec5 --- /dev/null +++ b/clio-kit-mcp-servers/hdf5/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-hdf5": { + "command": "uvx", + "args": [ + "clio-kit", + "hdf5" + ] + } +} diff --git a/clio-kit-mcp-servers/hdf5/README.md b/clio-kit-mcp-servers/hdf5/README.md index bf8c3c6a..14e0e6d8 100644 --- a/clio-kit-mcp-servers/hdf5/README.md +++ b/clio-kit-mcp-servers/hdf5/README.md @@ -308,3 +308,418 @@ IoWarp is a collection of Model Context Protocol (MCP) servers designed specific - **Consistent interfaces** across all scientific data formats The HDF5 server is the flagship implementation, showcasing the full power of FastMCP for scientific computing. + +## Capabilities + +### `open_file` +**Description**: Open an HDF5 file for operations. + +Args: + path: Path to HDF5 file + mode: File access mode ('r', 'r+', 'w', 'a') + +Returns: + Success message with file info +**Tags**: core, file + +### `close_file` +**Description**: Close the current HDF5 file. + +Returns: + Status message +**Tags**: core, file + +### `get_filename` +**Description**: Get the current file's path. + +Returns: + File path +**Hints**: read-only, idempotent +**Tags**: file, info + +### `get_mode` +**Description**: Get the current file's access mode. + +Returns: + File mode +**Hints**: read-only, idempotent +**Tags**: file, info + +### `get_by_path` +**Description**: Get a dataset or group by path. + +Args: + path: Path to object within file + +Returns: + Object information +**Hints**: read-only, idempotent +**Tags**: dataset, navigation + +### `list_keys` +**Description**: List keys in a group. + +Args: + path: Path to group (default: root) + +Returns: + JSON array of keys +**Hints**: read-only, idempotent +**Tags**: dataset, navigation + +### `visit` +**Description**: Visit all nodes recursively. + +Args: + callback_fn: Callback function name (currently collects all paths) + +Returns: + JSON array of all paths and types +**Hints**: read-only, idempotent +**Tags**: dataset, navigation + +### `read_full_dataset` +**Description**: Read an entire dataset with efficient chunked reading for large datasets. + +Args: + path: Path to dataset within file + +Returns: + Dataset description +**Hints**: read-only, idempotent +**Tags**: dataset, read + +### `read_partial_dataset` +**Description**: Read a portion of a dataset with slicing. + +Args: + path: Path to dataset within file + start: Starting indices as comma-separated string (e.g., "0,0,0") + count: Number of elements as comma-separated string (e.g., "10,10,10") + +Returns: + Partial dataset description +**Hints**: read-only, idempotent +**Tags**: dataset, read + +### `get_shape` +**Description**: Get the shape of a dataset. + +Args: + path: Path to dataset + +Returns: + Dataset shape +**Hints**: read-only, idempotent +**Tags**: dataset, metadata + +### `get_dtype` +**Description**: Get the data type of a dataset. + +Args: + path: Path to dataset + +Returns: + Dataset dtype +**Hints**: read-only, idempotent +**Tags**: dataset, metadata + +### `get_size` +**Description**: Get the size of a dataset. + +Args: + path: Path to dataset + +Returns: + Dataset size +**Hints**: read-only, idempotent +**Tags**: dataset, metadata + +### `get_chunks` +**Description**: Get chunk information for a dataset. + +Args: + path: Path to dataset + +Returns: + Chunk configuration +**Hints**: read-only, idempotent +**Tags**: dataset, metadata, performance + +### `read_attribute` +**Description**: Read an attribute from an object. + +Args: + path: Path to object + name: Attribute name + +Returns: + Attribute value +**Hints**: read-only, idempotent +**Tags**: attribute, metadata + +### `list_attributes` +**Description**: List all attributes of an object. + +Args: + path: Path to object + +Returns: + JSON dict of attributes +**Hints**: read-only, idempotent +**Tags**: attribute, metadata + +### `hdf5_parallel_scan` +**Description**: Fast multi-file scanning with parallel processing. + +Args: + directory: Directory to scan + pattern: File pattern (default: *.h5) + ctx: Context for progress reporting + +Returns: + Scan summary with file metadata +**Hints**: read-only, idempotent +**Tags**: parallel, performance, scan + +### `hdf5_batch_read` +**Description**: Read multiple datasets in parallel. + +Args: + paths: Comma-separated dataset paths or JSON array + slice_spec: Optional slice specification + ctx: Context for progress reporting + +Returns: + Batch read summary +**Hints**: read-only, idempotent +**Tags**: parallel, performance, read + +### `hdf5_stream_data` +**Description**: Stream large datasets efficiently with memory management. + +Args: + path: Path to dataset + chunk_size: Number of elements per chunk + max_chunks: Maximum number of chunks to process + ctx: Context for progress reporting + +Returns: + Stream processing summary with statistics +**Hints**: read-only, idempotent +**Tags**: performance, streaming + +### `hdf5_aggregate_stats` +**Description**: Parallel statistics computation across multiple datasets. + +Args: + paths: Comma-separated dataset paths or JSON array + stats: Comma-separated stats to compute (default: mean,std,min,max,sum,count) + ctx: Context for progress reporting + +Returns: + Aggregate statistics summary +**Hints**: read-only, idempotent +**Tags**: analysis, parallel, performance + +### `analyze_dataset_structure` +**Description**: Analyze and understand file organization and data patterns with AI insights. + +Args: + path: Path to analyze (default: root) + ctx: Context for LLM sampling + +Returns: + Structure analysis with AI insights +**Hints**: read-only, idempotent +**Tags**: ai-powered, analysis, discovery + +### `find_similar_datasets` +**Description**: Find datasets with similar characteristics to a reference dataset with AI analysis. + +Args: + reference_path: Path to reference dataset + similarity_threshold: Similarity threshold (0.0 to 1.0) + ctx: Context for LLM sampling + +Returns: + List of similar datasets with similarity scores and AI insights +**Hints**: read-only, idempotent +**Tags**: ai-powered, discovery, similarity + +### `suggest_next_exploration` +**Description**: Suggest interesting data to explore next based on current location with AI recommendations. + +Args: + current_path: Current path (default: root) + ctx: Context for LLM sampling + +Returns: + Exploration suggestions with interest scores and AI recommendations +**Hints**: read-only, idempotent +**Tags**: ai-powered, discovery, recommendation + +### `identify_io_bottlenecks` +**Description**: Identify potential I/O bottlenecks and performance issues with AI recommendations. + +Args: + analysis_paths: Optional list of paths to analyze (auto-discovers if None) + ctx: Context for LLM sampling + +Returns: + Bottleneck analysis report with AI recommendations +**Hints**: read-only, idempotent +**Tags**: ai-powered, discovery, performance + +### `optimize_access_pattern` +**Description**: Suggest better approaches for data access based on usage patterns. + +Args: + dataset_path: Path to dataset + access_pattern: Access pattern (sequential, random, batch) + +Returns: + Optimization recommendations +**Hints**: read-only, idempotent +**Tags**: discovery, optimization, performance + +### `refresh_hdf5_resources` +**Description**: Re-scan client roots and update available HDF5 resources. + +FastMCP automatically sends notifications/resources/list_changed to clients. + +Returns: + Summary of refreshed resources +**Tags**: admin, discovery + +### `list_available_hdf5_files` +**Description**: List all registered HDF5 files with resource URIs for Claude Code @ mentions. + +Returns: + List of available files with resource URIs +**Hints**: read-only, idempotent +**Tags**: discovery, helper + +### `export_dataset` +**Description**: Export dataset to various formats with user format selection. + +Args: + path: Path to dataset within file + output_path: Optional output file path + ctx: Context for elicitation + +Returns: + Export summary +**Tags**: dataset, export, interactive + +### Resources + +- `hdf5://{file_path}/metadata` - Expose HDF5 file metadata as resource. + +Args: + file_path: Path to HDF5 file + +Returns: + JSON metadata +- `hdf5://{file_path}/datasets/{dataset_path*}` - Expose HDF5 dataset as resource. + +Args: + file_path: Path to HDF5 file + dataset_path: Path to dataset within file (supports nested paths) + +Returns: + Dataset data (preview for large datasets) +- `hdf5://{file_path}/structure` - Expose HDF5 file structure as resource. + +Args: + file_path: Path to HDF5 file + +Returns: + Hierarchical structure + +### Prompts + +- **explore_hdf5_file**: Generate workflow for exploring an HDF5 file. + +Args: + file_path: Path to HDF5 file + +Returns: + Exploration workflow prompt +- **optimize_hdf5_access**: Generate optimization workflow for HDF5 I/O. + +Args: + file_path: Path to HDF5 file + access_pattern: Access pattern (sequential, random, batch) + +Returns: + Optimization workflow prompt +- **compare_hdf5_datasets**: Generate comparison workflow for two datasets. + +Args: + file_path: Path to HDF5 file + dataset1: First dataset path + dataset2: Second dataset path + +Returns: + Comparison workflow prompt +- **batch_process_hdf5**: Generate batch processing workflow for multiple HDF5 files. + +Args: + directory: Directory containing HDF5 files + operation: Operation to perform (statistics, scan, export) + +Returns: + Batch processing workflow prompt +## Claude Code + +```bash +claude mcp add clio-hdf5 -- uvx clio-kit hdf5 +``` + +Or install via the CLIO Kit plugin marketplace: + +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-hdf5@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-hdf5": { + "command": "uvx", + "args": [ + "clio-kit", + "hdf5" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-hdf5": { + "command": "uvx", + "args": [ + "clio-kit", + "hdf5" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` \ No newline at end of file diff --git a/clio-kit-mcp-servers/hdf5/pyproject.toml b/clio-kit-mcp-servers/hdf5/pyproject.toml index faca4273..c5e5ad8d 100644 --- a/clio-kit-mcp-servers/hdf5/pyproject.toml +++ b/clio-kit-mcp-servers/hdf5/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["hdf5", "scientific-data", "hierarchical-data", "data-analysis", "scientific-computing", "mcp", "llm-integration", "data-structures"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "h5py>=3.15.0", "numpy>=2.0.0", "pydantic>=2.4.2,<3.0.0", diff --git a/clio-kit-mcp-servers/hdf5/server.json b/clio-kit-mcp-servers/hdf5/server.json new file mode 100644 index 00000000..efee0f88 --- /dev/null +++ b/clio-kit-mcp-servers/hdf5/server.json @@ -0,0 +1,165 @@ +{ + "name": "io.github.iowarp/hdf5-mcp", + "description": "HDF5 FastMCP - Scientific Data Access for AI Agents | CLIO Kit MCP Server", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "hdf5" + ] + }, + "tools": [ + { + "name": "open_file", + "description": "Open an HDF5 file for operations.\n\nArgs:\n path: Path to HDF5 file\n mode: File access mode ('r', 'r+', 'w', 'a')\n\nReturns:\n Success message with file info" + }, + { + "name": "close_file", + "description": "Close the current HDF5 file.\n\nReturns:\n Status message" + }, + { + "name": "get_filename", + "description": "Get the current file's path.\n\nReturns:\n File path" + }, + { + "name": "get_mode", + "description": "Get the current file's access mode.\n\nReturns:\n File mode" + }, + { + "name": "get_by_path", + "description": "Get a dataset or group by path.\n\nArgs:\n path: Path to object within file\n\nReturns:\n Object information" + }, + { + "name": "list_keys", + "description": "List keys in a group.\n\nArgs:\n path: Path to group (default: root)\n\nReturns:\n JSON array of keys" + }, + { + "name": "visit", + "description": "Visit all nodes recursively.\n\nArgs:\n callback_fn: Callback function name (currently collects all paths)\n\nReturns:\n JSON array of all paths and types" + }, + { + "name": "read_full_dataset", + "description": "Read an entire dataset with efficient chunked reading for large datasets.\n\nArgs:\n path: Path to dataset within file\n\nReturns:\n Dataset description" + }, + { + "name": "read_partial_dataset", + "description": "Read a portion of a dataset with slicing.\n\nArgs:\n path: Path to dataset within file\n start: Starting indices as comma-separated string (e.g., \"0,0,0\")\n count: Number of elements as comma-separated string (e.g., \"10,10,10\")\n\nReturns:\n Partial dataset description" + }, + { + "name": "get_shape", + "description": "Get the shape of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset shape" + }, + { + "name": "get_dtype", + "description": "Get the data type of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset dtype" + }, + { + "name": "get_size", + "description": "Get the size of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset size" + }, + { + "name": "get_chunks", + "description": "Get chunk information for a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Chunk configuration" + }, + { + "name": "read_attribute", + "description": "Read an attribute from an object.\n\nArgs:\n path: Path to object\n name: Attribute name\n\nReturns:\n Attribute value" + }, + { + "name": "list_attributes", + "description": "List all attributes of an object.\n\nArgs:\n path: Path to object\n\nReturns:\n JSON dict of attributes" + }, + { + "name": "hdf5_parallel_scan", + "description": "Fast multi-file scanning with parallel processing.\n\nArgs:\n directory: Directory to scan\n pattern: File pattern (default: *.h5)\n ctx: Context for progress reporting\n\nReturns:\n Scan summary with file metadata" + }, + { + "name": "hdf5_batch_read", + "description": "Read multiple datasets in parallel.\n\nArgs:\n paths: Comma-separated dataset paths or JSON array\n slice_spec: Optional slice specification\n ctx: Context for progress reporting\n\nReturns:\n Batch read summary" + }, + { + "name": "hdf5_stream_data", + "description": "Stream large datasets efficiently with memory management.\n\nArgs:\n path: Path to dataset\n chunk_size: Number of elements per chunk\n max_chunks: Maximum number of chunks to process\n ctx: Context for progress reporting\n\nReturns:\n Stream processing summary with statistics" + }, + { + "name": "hdf5_aggregate_stats", + "description": "Parallel statistics computation across multiple datasets.\n\nArgs:\n paths: Comma-separated dataset paths or JSON array\n stats: Comma-separated stats to compute (default: mean,std,min,max,sum,count)\n ctx: Context for progress reporting\n\nReturns:\n Aggregate statistics summary" + }, + { + "name": "analyze_dataset_structure", + "description": "Analyze and understand file organization and data patterns with AI insights.\n\nArgs:\n path: Path to analyze (default: root)\n ctx: Context for LLM sampling\n\nReturns:\n Structure analysis with AI insights" + }, + { + "name": "find_similar_datasets", + "description": "Find datasets with similar characteristics to a reference dataset with AI analysis.\n\nArgs:\n reference_path: Path to reference dataset\n similarity_threshold: Similarity threshold (0.0 to 1.0)\n ctx: Context for LLM sampling\n\nReturns:\n List of similar datasets with similarity scores and AI insights" + }, + { + "name": "suggest_next_exploration", + "description": "Suggest interesting data to explore next based on current location with AI recommendations.\n\nArgs:\n current_path: Current path (default: root)\n ctx: Context for LLM sampling\n\nReturns:\n Exploration suggestions with interest scores and AI recommendations" + }, + { + "name": "identify_io_bottlenecks", + "description": "Identify potential I/O bottlenecks and performance issues with AI recommendations.\n\nArgs:\n analysis_paths: Optional list of paths to analyze (auto-discovers if None)\n ctx: Context for LLM sampling\n\nReturns:\n Bottleneck analysis report with AI recommendations" + }, + { + "name": "optimize_access_pattern", + "description": "Suggest better approaches for data access based on usage patterns.\n\nArgs:\n dataset_path: Path to dataset\n access_pattern: Access pattern (sequential, random, batch)\n\nReturns:\n Optimization recommendations" + }, + { + "name": "refresh_hdf5_resources", + "description": "Re-scan client roots and update available HDF5 resources.\n\nFastMCP automatically sends notifications/resources/list_changed to clients.\n\nReturns:\n Summary of refreshed resources" + }, + { + "name": "list_available_hdf5_files", + "description": "List all registered HDF5 files with resource URIs for Claude Code @ mentions.\n\nReturns:\n List of available files with resource URIs" + }, + { + "name": "export_dataset", + "description": "Export dataset to various formats with user format selection.\n\nArgs:\n path: Path to dataset within file\n output_path: Optional output file path\n ctx: Context for elicitation\n\nReturns:\n Export summary" + } + ], + "resource_templates": [ + { + "uri_template": "hdf5://{file_path}/metadata", + "name": "hdf5_file_metadata", + "description": "Expose HDF5 file metadata as resource.\n\nArgs:\n file_path: Path to HDF5 file\n\nReturns:\n JSON metadata" + }, + { + "uri_template": "hdf5://{file_path}/datasets/{dataset_path*}", + "name": "hdf5_dataset_resource", + "description": "Expose HDF5 dataset as resource.\n\nArgs:\n file_path: Path to HDF5 file\n dataset_path: Path to dataset within file (supports nested paths)\n\nReturns:\n Dataset data (preview for large datasets)" + }, + { + "uri_template": "hdf5://{file_path}/structure", + "name": "hdf5_structure_resource", + "description": "Expose HDF5 file structure as resource.\n\nArgs:\n file_path: Path to HDF5 file\n\nReturns:\n Hierarchical structure" + } + ], + "prompts": [ + { + "name": "explore_hdf5_file", + "description": "Generate workflow for exploring an HDF5 file.\n\nArgs:\n file_path: Path to HDF5 file\n\nReturns:\n Exploration workflow prompt" + }, + { + "name": "optimize_hdf5_access", + "description": "Generate optimization workflow for HDF5 I/O.\n\nArgs:\n file_path: Path to HDF5 file\n access_pattern: Access pattern (sequential, random, batch)\n\nReturns:\n Optimization workflow prompt" + }, + { + "name": "compare_hdf5_datasets", + "description": "Generate comparison workflow for two datasets.\n\nArgs:\n file_path: Path to HDF5 file\n dataset1: First dataset path\n dataset2: Second dataset path\n\nReturns:\n Comparison workflow prompt" + }, + { + "name": "batch_process_hdf5", + "description": "Generate batch processing workflow for multiple HDF5 files.\n\nArgs:\n directory: Directory containing HDF5 files\n operation: Operation to perform (statistics, scan, export)\n\nReturns:\n Batch processing workflow prompt" + } + ], + "tags": [ + "scientific-computing", + "hdf5", + "data-analysis", + "hierarchical-data" + ] +} diff --git a/clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py b/clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py index 286f60fd..21843f16 100644 --- a/clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py +++ b/clio-kit-mcp-servers/hdf5/src/hdf5_mcp/server.py @@ -65,7 +65,7 @@ import numpy as np from fastmcp import FastMCP, Context from fastmcp.exceptions import ToolError, ResourceError -from fastmcp.prompts.prompt import Message +from fastmcp.prompts import Message from .config import get_config from .resources import ResourceManager, LazyHDF5Proxy, discover_hdf5_files_in_roots @@ -129,7 +129,7 @@ async def lifespan(app): # Create FastMCP server with lifespan and instructions mcp = FastMCP( - name="HDF5", + name="hdf5", version="1.0.0", instructions=""" HDF5 FastMCP provides comprehensive HDF5 file operations with AI intelligence. @@ -157,6 +157,7 @@ async def lifespan(app): - Interactive export with format selection """, lifespan=lifespan, + list_page_size=10, ) # ========================================================================= @@ -2314,20 +2315,19 @@ async def cleanup(): def main(): """Main entry point for HDF5 FastMCP server.""" import argparse - import sys parser = argparse.ArgumentParser(description="IoWarp HDF5 FastMCP Server v1.0") parser.add_argument( "--transport", - choices=["stdio", "sse", "http"], - default="stdio", + choices=["stdio", "http"], + default=None, help="Transport protocol (default: stdio)", ) parser.add_argument( - "--host", default="0.0.0.0", help="Host for HTTP/SSE (default: 0.0.0.0)" + "--host", default="0.0.0.0", help="Host for HTTP transport (default: 0.0.0.0)" ) parser.add_argument( - "--port", type=int, default=8765, help="Port for HTTP/SSE (default: 8765)" + "--port", type=int, default=8765, help="Port for HTTP transport (default: 8765)" ) parser.add_argument("--data-dir", type=Path, help="Directory containing HDF5 files") parser.add_argument( @@ -2351,27 +2351,12 @@ def main(): # No need to call initialize() - lifespan handles it # Server initialization now happens in lifespan context manager - try: - # Run with selected transport - # The lifespan context manager will handle startup/shutdown - if args.transport == "stdio": - logger.info("Starting IoWarp HDF5 FastMCP with stdio transport") - mcp.run(transport="stdio") - elif args.transport == "sse": - logger.info( - f"Starting IoWarp HDF5 FastMCP with SSE transport on {args.host}:{args.port}" - ) - mcp.run(transport="sse", host=args.host, port=args.port) - elif args.transport == "http": - logger.info( - f"Starting IoWarp HDF5 FastMCP with HTTP transport on {args.host}:{args.port}" - ) - mcp.run(transport="http", host=args.host, port=args.port) - except KeyboardInterrupt: - logger.info("Server stopped by user") - except Exception as e: - logger.error(f"Server failed: {e}") - sys.exit(1) + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/hdf5/uv.lock b/clio-kit-mcp-servers/hdf5/uv.lock index f8d2322a..28e69233 100644 --- a/clio-kit-mcp-servers/hdf5/uv.lock +++ b/clio-kit-mcp-servers/hdf5/uv.lock @@ -1,5 +1,5 @@ version = 1 -revision = 3 +revision = 2 requires-python = ">=3.10" resolution-markers = [ "python_full_version >= '3.11'", @@ -459,18 +459,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.24.0" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/30/ca/7782da3b03242d5f0a16c20371dff99d4bd1fedafe26bc48ff82e42be8c9/cyclopts-3.24.0.tar.gz", hash = "sha256:de6964a041dfb3c57bf043b41e68c43548227a17de1bad246e3a0bfc5c4b7417", size = 76131, upload-time = "2025-09-08T15:40:57.75Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/f0/8b/2c95f0645c6f40211896375e6fa51f504b8ccb29c21f6ae661fe87ab044e/cyclopts-3.24.0-py3-none-any.whl", hash = "sha256:809d04cde9108617106091140c3964ee6fceb33cecdd537f7ffa360bde13ed71", size = 86154, upload-time = "2025-09-08T15:40:56.41Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -536,27 +537,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -644,7 +651,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "h5py", specifier = ">=3.15.0" }, { name = "numpy", specifier = ">=2.0.0" }, { name = "psutil", specifier = ">=5.9.0" }, @@ -773,6 +780,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -847,7 +863,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -861,11 +877,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -1101,6 +1119,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -1173,15 +1204,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1196,19 +1227,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.23" @@ -1913,6 +1931,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ee/d9/d88e73ca598f4f6ff671fb5fde8a32925c2e08a637303a1d12883c7305fa/uvicorn-0.38.0-py3-none-any.whl", hash = "sha256:48c0afd214ceb59340075b4a052ea1ee91c16fbc2a9b1469cca0e54566977b02", size = 68109, upload-time = "2025-10-18T13:46:42.958Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/jarvis/.claude-plugin/plugin.json b/clio-kit-mcp-servers/jarvis/.claude-plugin/plugin.json new file mode 100644 index 00000000..430bc667 --- /dev/null +++ b/clio-kit-mcp-servers/jarvis/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-jarvis", + "description": "Jarvis-CD MCP - Pipeline Management for High-Performance Computing with comprehensive workflow operations", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/jarvis/.mcp.json b/clio-kit-mcp-servers/jarvis/.mcp.json new file mode 100644 index 00000000..bcc83a7a --- /dev/null +++ b/clio-kit-mcp-servers/jarvis/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-jarvis": { + "command": "uvx", + "args": [ + "clio-kit", + "jarvis" + ] + } +} diff --git a/clio-kit-mcp-servers/jarvis/README.md b/clio-kit-mcp-servers/jarvis/README.md index 0767d977..0c8db725 100644 --- a/clio-kit-mcp-servers/jarvis/README.md +++ b/clio-kit-mcp-servers/jarvis/README.md @@ -131,227 +131,196 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\jarvis run jarvis-mc ## Capabilities ### `update_pipeline` -**Description**: Re-apply environment and configuration to every package in a Jarvis pipeline. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline to update - -**Returns**: dict: Status and results of the update operation. +**Description**: Re-apply environment and configuration to every package in a pipeline. +**Tags**: jarvis, pipeline ### `build_pipeline_env` -**Description**: Build the pipeline execution environment for a given pipeline. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline to build - -**Returns**: dict: Status and results of the environment build operation. +**Description**: Rebuild a pipeline's env.yaml, capturing CMAKE_PREFIX_PATH and PATH. +**Tags**: jarvis, pipeline ### `create_pipeline` -**Description**: Create a new pipeline environment for data-centric workflows. - -**Parameters**: -- `pipeline_id` (str): Name/ID for the new pipeline - -**Returns**: dict: Status and details of the created pipeline. +**Description**: Create a new Jarvis-CD pipeline environment. +**Tags**: jarvis, pipeline ### `load_pipeline` -**Description**: Load an existing pipeline environment by ID, or the current one if not specified. - -**Parameters**: -- `pipeline_id` (str, optional): ID of the pipeline to load - -**Returns**: dict: Status and details of the loaded pipeline. +**Description**: Load an existing Jarvis-CD pipeline environment. +**Hints**: read-only, idempotent +**Tags**: jarvis, pipeline ### `get_pkg_config` **Description**: Retrieve the configuration of a specific package in a pipeline. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline -- `pkg_id` (str): ID of the package - -**Returns**: dict: Current configuration of the package. +**Hints**: read-only, idempotent +**Tags**: jarvis, pipeline ### `append_pkg` -**Description**: Add a package to a pipeline for execution or analysis. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline -- `pkg_type` (str): Type of package to add -- `pkg_id` (str, optional): ID for the new package -- `do_configure` (bool, optional): Whether to configure after adding -- `extra_args` (dict, optional): Additional configuration arguments - -**Returns**: dict: Status and details of the package addition. +**Description**: Append a package to a Jarvis-CD pipeline. +**Tags**: jarvis, pipeline ### `configure_pkg` -**Description**: Configure a package in a pipeline with new settings. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline -- `pkg_id` (str): ID of the package -- `extra_args` (dict, optional): Configuration arguments - -**Returns**: dict: Status and details of the configuration operation. +**Description**: Configure a package in a Jarvis-CD pipeline. +**Tags**: jarvis, pipeline ### `unlink_pkg` -**Description**: Unlink a package from a pipeline without deleting its files. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline -- `pkg_id` (str): ID of the package to unlink - -**Returns**: dict: Status and details of the unlink operation. +**Description**: Unlink a package from a pipeline (preserve files). +**Tags**: jarvis, pipeline ### `remove_pkg` -**Description**: Remove a package and its files from a pipeline. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline -- `pkg_id` (str): ID of the package to remove - -**Returns**: dict: Status and details of the removal operation. +**Description**: Remove a package entirely from a pipeline. +**Hints**: destructive, idempotent +**Tags**: jarvis, pipeline ### `run_pipeline` -**Description**: Execute the pipeline, running all configured steps. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline to run - -**Returns**: dict: Status and results of the pipeline execution. +**Description**: Execute a Jarvis-CD pipeline end-to-end. +**Tags**: jarvis, pipeline ### `destroy_pipeline` -**Description**: Destroy a pipeline and clean up all associated files and resources. - -**Parameters**: -- `pipeline_id` (str): ID of the pipeline to destroy - -**Returns**: dict: Status and details of the destruction operation. +**Description**: Destroy a pipeline environment and clean up files. +**Hints**: destructive, idempotent +**Tags**: jarvis, pipeline ### `jm_create_config` -**Description**: Initialize manager directories and persist configuration. - -**Parameters**: -- `config_dir` (str): Parameter for config_dir -- `private_dir` (str): Parameter for private_dir -- `shared_dir` (Any, optional): Parameter for shared_dir - -**Returns**: Returns list +**Description**: Initialize JarvisManager config directories. +**Tags**: jarvis, management ### `jm_load_config` -**Description**: Load manager configuration from saved state. - -**Returns**: Returns list +**Description**: Load existing JarvisManager configuration. +**Hints**: read-only, idempotent +**Tags**: jarvis, management ### `jm_save_config` -**Description**: Save current configuration state to disk. - -**Returns**: Returns list +**Description**: Save current JarvisManager configuration. +**Hints**: idempotent +**Tags**: jarvis, management ### `jm_set_hostfile` -**Description**: Set and save the path to the hostfile for deployments. - -**Parameters**: -- `path` (str): Parameter for path - -**Returns**: Returns list +**Description**: Set hostfile path for JarvisManager. +**Hints**: idempotent +**Tags**: jarvis, management ### `jm_bootstrap_from` -**Description**: Bootstrap configuration based on a predefined machine template. - -**Parameters**: -- `machine` (str): Parameter for machine - -**Returns**: Returns list +**Description**: Bootstrap Jarvis config from a machine template. +**Tags**: jarvis, management ### `jm_bootstrap_list` -**Description**: List all bootstrap templates available. - -**Returns**: Returns list +**Description**: List available bootstrap machine templates. +**Hints**: read-only, idempotent +**Tags**: jarvis, management ### `jm_reset` -**Description**: Reset manager to a clean state by destroying all pipelines and config. - -**Returns**: Returns list +**Description**: Reset JarvisManager (destroy all pipelines and data). +**Hints**: destructive, idempotent +**Tags**: jarvis, management ### `jm_list_pipelines` -**Description**: List all current pipelines under management. - -**Returns**: Returns list +**Description**: List all existing Jarvis pipelines. +**Hints**: read-only, idempotent +**Tags**: jarvis, monitoring ### `jm_cd` -**Description**: Set the working pipeline context. - -**Parameters**: -- `pipeline_id` (str): Parameter for pipeline_id - -**Returns**: Returns list +**Description**: Change current Jarvis pipeline context. +**Hints**: idempotent +**Tags**: jarvis, management ### `jm_list_repos` -**Description**: List all registered repositories. - -**Returns**: Returns list +**Description**: List all Jarvis repositories. +**Hints**: read-only, idempotent +**Tags**: jarvis, monitoring ### `jm_add_repo` -**Description**: Add a repository path to the manager. - -**Parameters**: -- `path` (str): Parameter for path -- `force` (bool, optional): Parameter for force (default: False) - -**Returns**: Returns list +**Description**: Add a repository to JarvisManager. +**Tags**: jarvis, management ### `jm_remove_repo` -**Description**: Remove a repository from configuration. +**Description**: Remove a repository from JarvisManager. +**Hints**: destructive, idempotent +**Tags**: jarvis, management -**Parameters**: -- `repo_name` (str): Parameter for repo_name +### `jm_promote_repo` +**Description**: Promote a repository in JarvisManager. +**Hints**: idempotent +**Tags**: jarvis, management -**Returns**: Returns list +### `jm_get_repo` +**Description**: Get repository info from JarvisManager. +**Hints**: read-only, idempotent +**Tags**: jarvis, monitoring -### `jm_promote_repo` -**Description**: Promote a repository to higher priority. +### `jm_construct_pkg` +**Description**: Construct a package skeleton in JarvisManager. +**Tags**: jarvis, pipeline -**Parameters**: -- `repo_name` (str): Parameter for repo_name +### `jm_graph_show` +**Description**: Print the current resource graph frames. +**Hints**: read-only, idempotent +**Tags**: jarvis, monitoring -**Returns**: Returns list +### `jm_graph_build` +**Description**: Build or rebuild the resource graph with a net sleep interval. +**Tags**: jarvis, pipeline -### `jm_get_repo` -**Description**: Get detailed information about a repository. +### `jm_graph_modify` +**Description**: Modify the resource graph using a net sleep interval. +**Tags**: jarvis, pipeline -**Parameters**: -- `repo_name` (str): Parameter for repo_name +### Resources -**Returns**: Returns list +- `jarvis://capabilities` - JARVIS data pipeline capabilities. -### `jm_construct_pkg` -**Description**: Generate a new package skeleton by type. +### Prompts -**Parameters**: -- `pkg_type` (str): Parameter for pkg_type +- **create_pipeline_workflow**: Guided workflow for creating and deploying a JARVIS pipeline. +## Claude Code -**Returns**: Returns list +```bash +claude mcp add clio-jarvis -- uvx clio-kit jarvis +``` -### `jm_graph_show` -**Description**: Print the resource graph to the console. +Or install via the CLIO Kit plugin marketplace: -**Returns**: Returns list +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-jarvis@iowarp-clio-kit +``` +## Claude Desktop -### `jm_graph_build` -**Description**: Construct or rebuild the graph with a given sleep delay. +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Parameters**: -- `net_sleep` (float): Parameter for net_sleep +```json +{ + "mcpServers": { + "clio-jarvis": { + "command": "uvx", + "args": [ + "clio-kit", + "jarvis" + ] + } + } +} +``` +## Gemini CLI -**Returns**: Returns list +Add to `~/.gemini/settings.json`: -### `jm_graph_modify` -**Description**: Modify the current resource graph with a delay between operations. +```json +{ + "mcpServers": { + "clio-jarvis": { + "command": "uvx", + "args": [ + "clio-kit", + "jarvis" + ] + } + } +} +``` -**Parameters**: -- `net_sleep` (float): Parameter for net_sleep +Or install the CLIO Kit extension: -**Returns**: Returns list +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Pipeline Creation and Basic Management diff --git a/clio-kit-mcp-servers/jarvis/pyproject.toml b/clio-kit-mcp-servers/jarvis/pyproject.toml index d5e65f0d..232e00c9 100644 --- a/clio-kit-mcp-servers/jarvis/pyproject.toml +++ b/clio-kit-mcp-servers/jarvis/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["jarvis", "pipeline-management", "high-performance-computing", "hpc", "workflow", "data-pipelines", "scientific-computing", "mcp", "package-management"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "fastapi", "python-dotenv>=1.0.0", "jarvis-util @ git+https://github.com/grc-iit/jarvis-util.git@main#egg=jarvis-util", @@ -25,7 +25,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -jarvis-mcp = "server:main" +jarvis-mcp = "jarvis_mcp.server:main" [tool.uv] dev-dependencies = [ @@ -40,5 +40,16 @@ dev-dependencies = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.metadata] +allow-direct-references = true + +[tool.hatch.build.targets.wheel] +packages = ["src/jarvis_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/jarvis/server.json b/clio-kit-mcp-servers/jarvis/server.json new file mode 100644 index 00000000..859df880 --- /dev/null +++ b/clio-kit-mcp-servers/jarvis/server.json @@ -0,0 +1,150 @@ +{ + "name": "io.github.iowarp/jarvis-mcp", + "description": "Jarvis-CD MCP - Pipeline Management for High-Performance Computing with comprehensive workflow operations", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "jarvis" + ] + }, + "tools": [ + { + "name": "update_pipeline", + "description": "Re-apply environment and configuration to every package in a pipeline." + }, + { + "name": "build_pipeline_env", + "description": "Rebuild a pipeline's env.yaml, capturing CMAKE_PREFIX_PATH and PATH." + }, + { + "name": "create_pipeline", + "description": "Create a new Jarvis-CD pipeline environment." + }, + { + "name": "load_pipeline", + "description": "Load an existing Jarvis-CD pipeline environment." + }, + { + "name": "get_pkg_config", + "description": "Retrieve the configuration of a specific package in a pipeline." + }, + { + "name": "append_pkg", + "description": "Append a package to a Jarvis-CD pipeline." + }, + { + "name": "configure_pkg", + "description": "Configure a package in a Jarvis-CD pipeline." + }, + { + "name": "unlink_pkg", + "description": "Unlink a package from a pipeline (preserve files)." + }, + { + "name": "remove_pkg", + "description": "Remove a package entirely from a pipeline." + }, + { + "name": "run_pipeline", + "description": "Execute a Jarvis-CD pipeline end-to-end." + }, + { + "name": "destroy_pipeline", + "description": "Destroy a pipeline environment and clean up files." + }, + { + "name": "jm_create_config", + "description": "Initialize JarvisManager config directories." + }, + { + "name": "jm_load_config", + "description": "Load existing JarvisManager configuration." + }, + { + "name": "jm_save_config", + "description": "Save current JarvisManager configuration." + }, + { + "name": "jm_set_hostfile", + "description": "Set hostfile path for JarvisManager." + }, + { + "name": "jm_bootstrap_from", + "description": "Bootstrap Jarvis config from a machine template." + }, + { + "name": "jm_bootstrap_list", + "description": "List available bootstrap machine templates." + }, + { + "name": "jm_reset", + "description": "Reset JarvisManager (destroy all pipelines and data)." + }, + { + "name": "jm_list_pipelines", + "description": "List all existing Jarvis pipelines." + }, + { + "name": "jm_cd", + "description": "Change current Jarvis pipeline context." + }, + { + "name": "jm_list_repos", + "description": "List all Jarvis repositories." + }, + { + "name": "jm_add_repo", + "description": "Add a repository to JarvisManager." + }, + { + "name": "jm_remove_repo", + "description": "Remove a repository from JarvisManager." + }, + { + "name": "jm_promote_repo", + "description": "Promote a repository in JarvisManager." + }, + { + "name": "jm_get_repo", + "description": "Get repository info from JarvisManager." + }, + { + "name": "jm_construct_pkg", + "description": "Construct a package skeleton in JarvisManager." + }, + { + "name": "jm_graph_show", + "description": "Print the current resource graph frames." + }, + { + "name": "jm_graph_build", + "description": "Build or rebuild the resource graph with a net sleep interval." + }, + { + "name": "jm_graph_modify", + "description": "Modify the resource graph using a net sleep interval." + } + ], + "resources": [ + { + "uri": "jarvis://capabilities", + "name": "jarvis_capabilities", + "description": "JARVIS data pipeline capabilities." + } + ], + "prompts": [ + { + "name": "create_pipeline_workflow", + "description": "Guided workflow for creating and deploying a JARVIS pipeline." + } + ], + "tags": [ + "pipeline-management", + "hpc", + "workflow-automation" + ] +} diff --git a/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/__init__.py b/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/jarvis/src/capabilities/__init__.py b/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/__init__.py similarity index 100% rename from clio-kit-mcp-servers/jarvis/src/capabilities/__init__.py rename to clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/__init__.py diff --git a/clio-kit-mcp-servers/jarvis/src/capabilities/jarvis_handler.py b/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/jarvis_handler.py similarity index 100% rename from clio-kit-mcp-servers/jarvis/src/capabilities/jarvis_handler.py rename to clio-kit-mcp-servers/jarvis/src/jarvis_mcp/capabilities/jarvis_handler.py diff --git a/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/server.py b/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/server.py new file mode 100644 index 00000000..69ea0375 --- /dev/null +++ b/clio-kit-mcp-servers/jarvis/src/jarvis_mcp/server.py @@ -0,0 +1,612 @@ +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +import os +from dotenv import load_dotenv +from typing import Optional +from .capabilities.jarvis_handler import ( + create_pipeline, + load_pipeline, + append_pkg, + configure_pkg, + unlink_pkg, + remove_pkg, + run_pipeline, + destroy_pipeline, + get_pkg_config, + update_pipeline, + build_pipeline_env, +) +from jarvis_cd.basic.jarvis_manager import JarvisManager + +# Load environment variables from .env file +load_dotenv() + +# Initialize FastMCP server instance +mcp: FastMCP = FastMCP( + "jarvis", + instructions=( + "Manages JARVIS data pipelines for scientific computing. " + "Create, configure, monitor, and manage data processing pipelines." + ), + list_page_size=10, +) + +# Create a singleton instance of JarvisManager +manager = JarvisManager.get_instance() + + +# ─── RESOURCE ──────────────────────────────────────────────────────────────── + + +@mcp.resource("jarvis://capabilities") +def jarvis_capabilities() -> dict: + """JARVIS data pipeline capabilities.""" + return { + "pipeline_types": ["streaming", "batch", "real-time"], + "operations": ["create", "configure", "deploy", "monitor", "destroy"], + } + + +# ─── PROMPT ────────────────────────────────────────────────────────────────── + + +@mcp.prompt() +def create_pipeline_workflow(name: str) -> list[Message]: + """Guided workflow for creating and deploying a JARVIS pipeline.""" + return [ + Message( + f"I need to create a new JARVIS pipeline called '{name}'. " + "Help me configure it, set up the processing stages, deploy it, " + "and verify it's running correctly." + ), + ] + + +# ─── PIPELINE TOOLS ───────────────────────────────────────────────────────────── + + +@mcp.tool( + name="update_pipeline", + description="Re-apply environment and configuration to every package in a pipeline.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def update_pipeline_tool(pipeline_id: str) -> dict: + """Re-apply environment and configuration to every package in a Jarvis pipeline.""" + return await update_pipeline(pipeline_id) + + +@mcp.tool( + name="build_pipeline_env", + description="Rebuild a pipeline's env.yaml, capturing CMAKE_PREFIX_PATH and PATH.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def build_pipeline_env_tool(pipeline_id: str) -> dict: + """Build the pipeline execution environment for a given pipeline.""" + return await build_pipeline_env(pipeline_id) + + +@mcp.tool( + name="create_pipeline", + description="Create a new Jarvis-CD pipeline environment.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def create_pipeline_tool(pipeline_id: str) -> dict: + """Create a new pipeline environment for data-centric workflows.""" + return await create_pipeline(pipeline_id) + + +@mcp.tool( + name="load_pipeline", + description="Load an existing Jarvis-CD pipeline environment.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "pipeline"}, +) +async def load_pipeline_tool(pipeline_id: Optional[str] = None) -> dict: + """Load an existing pipeline environment by ID, or the current one if not specified.""" + return await load_pipeline(pipeline_id) + + +@mcp.tool( + name="get_pkg_config", + description="Retrieve the configuration of a specific package in a pipeline.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "pipeline"}, +) +async def get_pkg_config_tool(pipeline_id: str, pkg_id: str) -> dict: + """Retrieve the configuration of a specific package in a pipeline.""" + return await get_pkg_config(pipeline_id, pkg_id) + + +@mcp.tool( + name="append_pkg", + description="Append a package to a Jarvis-CD pipeline.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def append_pkg_tool( + pipeline_id: str, + pkg_type: str, + pkg_id: Optional[str] = None, + do_configure: bool = True, + extra_args: Optional[dict] = None, +) -> dict: + """Add a package to a pipeline for execution or analysis.""" + return await append_pkg( + pipeline_id, + pkg_type, + pkg_id=pkg_id, + do_configure=do_configure, + **(extra_args or {}), + ) + + +@mcp.tool( + name="configure_pkg", + description="Configure a package in a Jarvis-CD pipeline.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def configure_pkg_tool( + pipeline_id: str, pkg_id: str, extra_args: Optional[dict] = None +) -> dict: + """Configure a package in a pipeline with new settings.""" + return await configure_pkg(pipeline_id, pkg_id, **(extra_args or {})) + + +@mcp.tool( + name="unlink_pkg", + description="Unlink a package from a pipeline (preserve files).", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def unlink_pkg_tool(pipeline_id: str, pkg_id: str) -> dict: + """Unlink a package from a pipeline without deleting its files.""" + return await unlink_pkg(pipeline_id, pkg_id) + + +@mcp.tool( + name="remove_pkg", + description="Remove a package entirely from a pipeline.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jarvis", "pipeline"}, +) +async def remove_pkg_tool(pipeline_id: str, pkg_id: str) -> dict: + """Remove a package and its files from a pipeline.""" + return await remove_pkg(pipeline_id, pkg_id) + + +@mcp.tool( + name="run_pipeline", + description="Execute a Jarvis-CD pipeline end-to-end.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +async def run_pipeline_tool(pipeline_id: str) -> dict: + """Execute the pipeline, running all configured steps.""" + return await run_pipeline(pipeline_id) + + +@mcp.tool( + name="destroy_pipeline", + description="Destroy a pipeline environment and clean up files.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jarvis", "pipeline"}, +) +async def destroy_pipeline_tool(pipeline_id: str) -> dict: + """Destroy a pipeline and clean up all associated files and resources.""" + return await destroy_pipeline(pipeline_id) + + +@mcp.tool( + name="jm_create_config", + description="Initialize JarvisManager config directories.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "management"}, +) +def jm_create_config( + config_dir: str, private_dir: str, shared_dir: Optional[str] = None +) -> list: + """Initialize manager directories and persist configuration.""" + try: + manager.create(config_dir, private_dir, shared_dir) + manager.save() + return [{"type": "text", "text": "Jarvis configuration initialized."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_load_config", + description="Load existing JarvisManager configuration.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_load_config() -> list: + """Load manager configuration from saved state.""" + try: + manager.load() + return [{"type": "text", "text": "Configuration loaded."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_save_config", + description="Save current JarvisManager configuration.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_save_config() -> list: + """Save current configuration state to disk.""" + try: + manager.save() + return [{"type": "text", "text": "Configuration saved."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_set_hostfile", + description="Set hostfile path for JarvisManager.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_set_hostfile(path: str) -> list: + """Set and save the path to the hostfile for deployments.""" + try: + manager.set_hostfile(path) + manager.save() + return [{"type": "text", "text": f"Hostfile set to '{path}'"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_bootstrap_from", + description="Bootstrap Jarvis config from a machine template.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "management"}, +) +def jm_bootstrap_from(machine: str) -> list: + """Bootstrap configuration based on a predefined machine template.""" + try: + manager.bootstrap_from(machine) + return [{"type": "text", "text": f"Bootstrapped from '{machine}'"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_bootstrap_list", + description="List available bootstrap machine templates.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_bootstrap_list() -> list: + """List all bootstrap templates available.""" + try: + return [{"type": "text", "text": m} for m in manager.bootstrap_list()] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_reset", + description="Reset JarvisManager (destroy all pipelines and data).", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_reset() -> list: + """Reset manager to a clean state by destroying all pipelines and config.""" + try: + manager.reset() + return [{"type": "text", "text": "All pipelines and data reset."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_list_pipelines", + description="List all existing Jarvis pipelines.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "monitoring"}, +) +def jm_list_pipelines() -> list: + """List all current pipelines under management.""" + try: + return [{"type": "text", "text": p} for p in manager.list_pipelines()] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_cd", + description="Change current Jarvis pipeline context.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_cd(pipeline_id: str) -> list: + """Set the working pipeline context.""" + try: + manager.cd(pipeline_id) + manager.save() + return [{"type": "text", "text": f"Current pipeline set to '{pipeline_id}'"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_list_repos", + description="List all Jarvis repositories.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "monitoring"}, +) +def jm_list_repos() -> list: + """List all registered repositories.""" + try: + return [{"type": "text", "text": str(repo)} for repo in manager.list_repos()] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_add_repo", + description="Add a repository to JarvisManager.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "management"}, +) +def jm_add_repo(path: str, force: bool = False) -> list: + """Add a repository path to the manager.""" + try: + manager.add_repo(path, force) + manager.save() + return [{"type": "text", "text": f"Repo added: {path}"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_remove_repo", + description="Remove a repository from JarvisManager.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_remove_repo(repo_name: str) -> list: + """Remove a repository from configuration.""" + try: + manager.remove_repo(repo_name) + manager.save() + return [{"type": "text", "text": f"Repo removed: {repo_name}"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_promote_repo", + description="Promote a repository in JarvisManager.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "management"}, +) +def jm_promote_repo(repo_name: str) -> list: + """Promote a repository to higher priority.""" + try: + manager.promote_repo(repo_name) + manager.save() + return [{"type": "text", "text": f"Repo promoted: {repo_name}"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_get_repo", + description="Get repository info from JarvisManager.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "monitoring"}, +) +def jm_get_repo(repo_name: str) -> list: + """Get detailed information about a repository.""" + try: + return [{"type": "text", "text": str(manager.get_repo(repo_name))}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_construct_pkg", + description="Construct a package skeleton in JarvisManager.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +def jm_construct_pkg(pkg_type: str) -> list: + """Generate a new package skeleton by type.""" + try: + obj = manager.construct_pkg(pkg_type) + return [{"type": "text", "text": f"Constructed pkg: {obj.__class__.__name__}"}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_graph_show", + description="Print the current resource graph frames.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jarvis", "monitoring"}, +) +def jm_graph_show() -> list: + """Print the resource graph to the console.""" + try: + manager.resource_graph_show() + return [{"type": "text", "text": "Resource graph printed to console."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_graph_build", + description="Build or rebuild the resource graph with a net sleep interval.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +def jm_graph_build(net_sleep: float) -> list: + """Construct or rebuild the graph with a given sleep delay.""" + try: + manager.resource_graph_build(net_sleep) + return [{"type": "text", "text": "Resource graph built."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +@mcp.tool( + name="jm_graph_modify", + description="Modify the resource graph using a net sleep interval.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jarvis", "pipeline"}, +) +def jm_graph_modify(net_sleep: float) -> list: + """Modify the current resource graph with a delay between operations.""" + try: + manager.resource_graph_modify(net_sleep) + return [{"type": "text", "text": "Resource graph modified."}] + except Exception as e: + raise ToolError(f"Error: {e}") + + +def main() -> None: + """Main entry point for the Jarvis MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Jarvis MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/jarvis/src/server.py b/clio-kit-mcp-servers/jarvis/src/server.py deleted file mode 100644 index b991cd85..00000000 --- a/clio-kit-mcp-servers/jarvis/src/server.py +++ /dev/null @@ -1,461 +0,0 @@ -from fastmcp import FastMCP -import os -import sys -from dotenv import load_dotenv -from typing import Optional -from capabilities.jarvis_handler import ( - create_pipeline, - load_pipeline, - append_pkg, - configure_pkg, - unlink_pkg, - remove_pkg, - run_pipeline, - destroy_pipeline, - get_pkg_config, - update_pipeline, - build_pipeline_env, -) -from jarvis_cd.basic.jarvis_manager import JarvisManager - -# Load environment variables from .env file -load_dotenv() - -# Initialize FastMCP server instance -mcp: FastMCP = FastMCP("JarvisServer") - -# Create a singleton instance of JarvisManager -manager = JarvisManager.get_instance() - - -# ─── PIPELINE TOOLS ───────────────────────────────────────────────────────────── - - -@mcp.tool( - name="update_pipeline", - description="Re-apply environment & configuration to every package in a Jarvis-CD pipeline.", -) -async def update_pipeline_tool(pipeline_id: str) -> dict: - """ - Re-apply environment and configuration to every package in a Jarvis pipeline. - - Args: - pipeline_id (str): ID of the pipeline to update - - Returns: - dict: Status and results of the update operation. - """ - return await update_pipeline(pipeline_id) - - -@mcp.tool( - name="build_pipeline_env", - description="Rebuild a Jarvis-CD pipeline’s env.yaml, capturing only CMAKE_PREFIX_PATH and PATH", -) -async def build_pipeline_env_tool(pipeline_id: str) -> dict: - """ - Build the pipeline execution environment for a given pipeline. - - Args: - pipeline_id (str): ID of the pipeline to build - - Returns: - dict: Status and results of the environment build operation. - """ - return await build_pipeline_env(pipeline_id) - - -@mcp.tool( - name="create_pipeline", description="Create a new Jarvis-CD pipeline environment." -) -async def create_pipeline_tool(pipeline_id: str) -> dict: - """ - Create a new pipeline environment for data-centric workflows. - - Args: - pipeline_id (str): Name/ID for the new pipeline - - Returns: - dict: Status and details of the created pipeline. - """ - return await create_pipeline(pipeline_id) - - -@mcp.tool( - name="load_pipeline", description="Load an existing Jarvis-CD pipeline environment." -) -async def load_pipeline_tool(pipeline_id: Optional[str] = None) -> dict: - """ - Load an existing pipeline environment by ID, or the current one if not specified. - - Args: - pipeline_id (str, optional): ID of the pipeline to load - - Returns: - dict: Status and details of the loaded pipeline. - """ - return await load_pipeline(pipeline_id) - - -@mcp.tool( - name="get_pkg_config", - description="Retrieve the configuration of a specific package in a Jarvis-CD pipeline.", -) -async def get_pkg_config_tool(pipeline_id: str, pkg_id: str) -> dict: - """ - Retrieve the configuration of a specific package in a pipeline. - - Args: - pipeline_id (str): ID of the pipeline - pkg_id (str): ID of the package - - Returns: - dict: Current configuration of the package. - """ - return await get_pkg_config(pipeline_id, pkg_id) - - -@mcp.tool(name="append_pkg", description="Append a package to a Jarvis-CD pipeline.") -async def append_pkg_tool( - pipeline_id: str, - pkg_type: str, - pkg_id: Optional[str] = None, - do_configure: bool = True, - extra_args: Optional[dict] = None, -) -> dict: - """ - Add a package to a pipeline for execution or analysis. - - Args: - pipeline_id (str): ID of the pipeline - pkg_type (str): Type of package to add - pkg_id (str, optional): ID for the new package - do_configure (bool, optional): Whether to configure after adding - extra_args (dict, optional): Additional configuration arguments - - Returns: - dict: Status and details of the package addition. - """ - return await append_pkg( - pipeline_id, - pkg_type, - pkg_id=pkg_id, - do_configure=do_configure, - **(extra_args or {}), - ) - - -@mcp.tool( - name="configure_pkg", description="Configure a package in a Jarvis-CD pipeline." -) -async def configure_pkg_tool( - pipeline_id: str, pkg_id: str, extra_args: Optional[dict] = None -) -> dict: - """ - Configure a package in a pipeline with new settings. - - Args: - pipeline_id (str): ID of the pipeline - pkg_id (str): ID of the package - extra_args (dict, optional): Configuration arguments - - Returns: - dict: Status and details of the configuration operation. - """ - return await configure_pkg(pipeline_id, pkg_id, **(extra_args or {})) - - -@mcp.tool( - name="unlink_pkg", - description="Unlink a package from a Jarvis-CD pipeline (preserve files).", -) -async def unlink_pkg_tool(pipeline_id: str, pkg_id: str) -> dict: - """ - Unlink a package from a pipeline without deleting its files. - - Args: - pipeline_id (str): ID of the pipeline - pkg_id (str): ID of the package to unlink - - Returns: - dict: Status and details of the unlink operation. - """ - return await unlink_pkg(pipeline_id, pkg_id) - - -@mcp.tool( - name="remove_pkg", - description="Remove a package entirely from a Jarvis-CD pipeline.", -) -async def remove_pkg_tool(pipeline_id: str, pkg_id: str) -> dict: - """ - Remove a package and its files from a pipeline. - - Args: - pipeline_id (str): ID of the pipeline - pkg_id (str): ID of the package to remove - - Returns: - dict: Status and details of the removal operation. - """ - return await remove_pkg(pipeline_id, pkg_id) - - -@mcp.tool(name="run_pipeline", description="Execute a Jarvis-CD pipeline end-to-end.") -async def run_pipeline_tool(pipeline_id: str) -> dict: - """ - Execute the pipeline, running all configured steps. - - Args: - pipeline_id (str): ID of the pipeline to run - - Returns: - dict: Status and results of the pipeline execution. - """ - return await run_pipeline(pipeline_id) - - -@mcp.tool( - name="destroy_pipeline", - description="Destroy a Jarvis-CD pipeline environment and clean up files.", -) -async def destroy_pipeline_tool(pipeline_id: str) -> dict: - """ - Destroy a pipeline and clean up all associated files and resources. - - Args: - pipeline_id (str): ID of the pipeline to destroy - - Returns: - dict: Status and details of the destruction operation. - """ - return await destroy_pipeline(pipeline_id) - - -@mcp.tool( - name="jm_create_config", description="Initialize JarvisManager config directories." -) -def jm_create_config( - config_dir: str, private_dir: str, shared_dir: Optional[str] = None -) -> list: - """Initialize manager directories and persist configuration.""" - try: - manager.create(config_dir, private_dir, shared_dir) - manager.save() - return [{"type": "text", "text": "Jarvis configuration initialized."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_load_config", description="Load existing JarvisManager configuration." -) -def jm_load_config() -> list: - """Load manager configuration from saved state.""" - try: - manager.load() - return [{"type": "text", "text": "Configuration loaded."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_save_config", description="Save current JarvisManager configuration." -) -def jm_save_config() -> list: - """Save current configuration state to disk.""" - try: - manager.save() - return [{"type": "text", "text": "Configuration saved."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_set_hostfile", description="Set hostfile path for JarvisManager.") -def jm_set_hostfile(path: str) -> list: - """Set and save the path to the hostfile for deployments.""" - try: - manager.set_hostfile(path) - manager.save() - return [{"type": "text", "text": f"Hostfile set to '{path}'"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_bootstrap_from", - description="Bootstrap Jarvis config from a machine template.", -) -def jm_bootstrap_from(machine: str) -> list: - """Bootstrap configuration based on a predefined machine template.""" - try: - manager.bootstrap_from(machine) - return [{"type": "text", "text": f"Bootstrapped from '{machine}'"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_bootstrap_list", description="List available bootstrap machine templates." -) -def jm_bootstrap_list() -> list: - """List all bootstrap templates available.""" - try: - return [{"type": "text", "text": m} for m in manager.bootstrap_list()] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_reset", description="Reset JarvisManager (destroy all pipelines and data)." -) -def jm_reset() -> list: - """Reset manager to a clean state by destroying all pipelines and config.""" - try: - manager.reset() - return [{"type": "text", "text": "All pipelines and data reset."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_list_pipelines", description="List all existing Jarvis pipelines.") -def jm_list_pipelines() -> list: - """List all current pipelines under management.""" - try: - return [{"type": "text", "text": p} for p in manager.list_pipelines()] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_cd", description="Change current Jarvis pipeline context.") -def jm_cd(pipeline_id: str) -> list: - """Set the working pipeline context.""" - try: - manager.cd(pipeline_id) - manager.save() - return [{"type": "text", "text": f"Current pipeline set to '{pipeline_id}'"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_list_repos", description="List all Jarvis repositories.") -def jm_list_repos() -> list: - """List all registered repositories.""" - try: - return [{"type": "text", "text": str(repo)} for repo in manager.list_repos()] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_add_repo", description="Add a repository to JarvisManager.") -def jm_add_repo(path: str, force: bool = False) -> list: - """Add a repository path to the manager.""" - try: - manager.add_repo(path, force) - manager.save() - return [{"type": "text", "text": f"Repo added: {path}"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_remove_repo", description="Remove a repository from JarvisManager.") -def jm_remove_repo(repo_name: str) -> list: - """Remove a repository from configuration.""" - try: - manager.remove_repo(repo_name) - manager.save() - return [{"type": "text", "text": f"Repo removed: {repo_name}"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_promote_repo", description="Promote a repository in JarvisManager.") -def jm_promote_repo(repo_name: str) -> list: - """Promote a repository to higher priority.""" - try: - manager.promote_repo(repo_name) - manager.save() - return [{"type": "text", "text": f"Repo promoted: {repo_name}"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_get_repo", description="Get repository info from JarvisManager.") -def jm_get_repo(repo_name: str) -> list: - """Get detailed information about a repository.""" - try: - return [{"type": "text", "text": str(manager.get_repo(repo_name))}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_construct_pkg", - description="Construct a package skeleton in JarvisManager.", -) -def jm_construct_pkg(pkg_type: str) -> list: - """Generate a new package skeleton by type.""" - try: - obj = manager.construct_pkg(pkg_type) - return [{"type": "text", "text": f"Constructed pkg: {obj.__class__.__name__}"}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool(name="jm_graph_show", description="Print the current resource graph frames.") -def jm_graph_show() -> list: - """Print the resource graph to the console.""" - try: - manager.resource_graph_show() - return [{"type": "text", "text": "Resource graph printed to console."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_graph_build", - description="Build or rebuild the resource graph with a net sleep interval.", -) -def jm_graph_build(net_sleep: float) -> list: - """Construct or rebuild the graph with a given sleep delay.""" - try: - manager.resource_graph_build(net_sleep) - return [{"type": "text", "text": "Resource graph built."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -@mcp.tool( - name="jm_graph_modify", - description="Modify the resource graph using a net sleep interval.", -) -def jm_graph_modify(net_sleep: float) -> list: - """Modify the current resource graph with a delay between operations.""" - try: - manager.resource_graph_modify(net_sleep) - return [{"type": "text", "text": "Resource graph modified."}] - except Exception as e: - return [{"type": "text", "text": f"Error: {e}"}] - - -def main(): - """ - Main entry point to start the FastMCP server using the specified transport. - Chooses between stdio and SSE based on MCP_TRANSPORT environment variable. - """ - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - if transport == "sse": - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - print(f"Starting SSE on {host}:{port}", file=sys.stderr) - mcp.run(transport="sse", host=host, port=port) - else: - print("Starting stdio transport", file=sys.stderr) - mcp.run(transport="stdio") - mcp.run( - transport="sse", - ) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/jarvis/tests/conftest.py b/clio-kit-mcp-servers/jarvis/tests/conftest.py index 38789868..6e147ba9 100644 --- a/clio-kit-mcp-servers/jarvis/tests/conftest.py +++ b/clio-kit-mcp-servers/jarvis/tests/conftest.py @@ -22,7 +22,7 @@ def temp_dir(): @pytest.fixture def mock_jarvis_manager(): """Mock JarvisManager instance.""" - with patch("server.JarvisManager") as mock_manager_class: + with patch("jarvis_mcp.server.JarvisManager") as mock_manager_class: mock_manager = Mock() mock_manager_class.get_instance.return_value = mock_manager @@ -52,7 +52,9 @@ def mock_jarvis_manager(): @pytest.fixture def mock_pipeline(): """Mock Pipeline instance.""" - with patch("capabilities.jarvis_handler.Pipeline") as mock_pipeline_class: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.Pipeline" + ) as mock_pipeline_class: mock_pipeline = Mock() mock_pipeline_class.return_value = mock_pipeline @@ -114,7 +116,7 @@ def sample_package_config(): @pytest.fixture def mock_fastmcp(): """Mock FastMCP instance.""" - with patch("server.FastMCP") as mock_mcp_class: + with patch("jarvis_mcp.server.FastMCP") as mock_mcp_class: mock_mcp = Mock(spec=FastMCP) mock_mcp_class.return_value = mock_mcp yield mock_mcp @@ -125,8 +127,8 @@ def mock_environment_vars(): """Mock environment variables for testing.""" env_vars = { "MCP_TRANSPORT": "stdio", - "MCP_SSE_HOST": "127.0.0.1", - "MCP_SSE_PORT": "8000", + "MCP_HTTP_HOST": "127.0.0.1", + "MCP_HTTP_PORT": "8000", } with patch.dict(os.environ, env_vars): @@ -173,6 +175,6 @@ def create_mock_response(status: str, data: Dict[str, Any] = None) -> Dict[str, @pytest.fixture def mock_dotenv(): """Mock dotenv loading.""" - with patch("server.load_dotenv") as mock_load: + with patch("jarvis_mcp.server.load_dotenv") as mock_load: mock_load.return_value = True yield mock_load diff --git a/clio-kit-mcp-servers/jarvis/tests/test_basic.py b/clio-kit-mcp-servers/jarvis/tests/test_basic.py index 6f2329ec..309cc07d 100644 --- a/clio-kit-mcp-servers/jarvis/tests/test_basic.py +++ b/clio-kit-mcp-servers/jarvis/tests/test_basic.py @@ -76,8 +76,8 @@ def test_project_structure(self): # Check for expected directories and files expected_paths = [ os.path.join(project_root, "src"), - os.path.join(project_root, "src", "server.py"), - os.path.join(project_root, "src", "capabilities"), + os.path.join(project_root, "src", "jarvis_mcp", "server.py"), + os.path.join(project_root, "src", "jarvis_mcp", "capabilities"), os.path.join(project_root, "pyproject.toml"), os.path.join(project_root, "README.md"), ] diff --git a/clio-kit-mcp-servers/jarvis/tests/test_jarvis_handler.py b/clio-kit-mcp-servers/jarvis/tests/test_jarvis_handler.py index b1b72c5d..aa256249 100644 --- a/clio-kit-mcp-servers/jarvis/tests/test_jarvis_handler.py +++ b/clio-kit-mcp-servers/jarvis/tests/test_jarvis_handler.py @@ -6,13 +6,7 @@ from unittest.mock import Mock, patch from fastapi import HTTPException -# Import the handler functions we want to test -import sys -import os - -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.jarvis_handler import ( +from jarvis_mcp.capabilities.jarvis_handler import ( create_pipeline, load_pipeline, append_pkg, @@ -376,7 +370,9 @@ async def test_http_exception_preservation(self, mock_pipeline): """Test that HTTPExceptions are preserved and re-raised.""" original_exception = HTTPException(status_code=404, detail="Not found") - with patch("capabilities.jarvis_handler.Pipeline") as mock_pipeline_class: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.Pipeline" + ) as mock_pipeline_class: mock_pipeline_instance = Mock() mock_pipeline_class.return_value = mock_pipeline_instance mock_pipeline_instance.load.side_effect = original_exception diff --git a/clio-kit-mcp-servers/jarvis/tests/test_server.py b/clio-kit-mcp-servers/jarvis/tests/test_server.py index 0f4d7e72..63874c04 100644 --- a/clio-kit-mcp-servers/jarvis/tests/test_server.py +++ b/clio-kit-mcp-servers/jarvis/tests/test_server.py @@ -13,7 +13,9 @@ class TestPipelineTools: @pytest.mark.asyncio async def test_create_pipeline_tool_success(self, mock_pipeline): """Test successful pipeline creation.""" - with patch("src.capabilities.jarvis_handler.create_pipeline") as mock_create: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.create_pipeline" + ) as mock_create: mock_create.return_value = { "pipeline_id": "test_pipeline", "status": "created", @@ -32,7 +34,9 @@ async def mock_create_pipeline_tool(pipeline_id: str): @pytest.mark.asyncio async def test_create_pipeline_tool_failure(self): """Test pipeline creation failure.""" - with patch("src.capabilities.jarvis_handler.create_pipeline") as mock_create: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.create_pipeline" + ) as mock_create: mock_create.side_effect = Exception("Creation failed") async def mock_create_pipeline_tool(pipeline_id: str): @@ -44,7 +48,7 @@ async def mock_create_pipeline_tool(pipeline_id: str): @pytest.mark.asyncio async def test_load_pipeline_tool_success(self): """Test successful pipeline loading.""" - with patch("src.capabilities.jarvis_handler.load_pipeline") as mock_load: + with patch("jarvis_mcp.capabilities.jarvis_handler.load_pipeline") as mock_load: mock_load.return_value = { "pipeline_id": "test_pipeline", "status": "loaded", @@ -62,7 +66,7 @@ async def mock_load_pipeline_tool(pipeline_id: str): @pytest.mark.asyncio async def test_load_pipeline_tool_no_id(self): """Test pipeline loading without specific ID.""" - with patch("src.capabilities.jarvis_handler.load_pipeline") as mock_load: + with patch("jarvis_mcp.capabilities.jarvis_handler.load_pipeline") as mock_load: mock_load.return_value = {"pipeline_id": None, "status": "loaded"} async def mock_load_pipeline_tool(pipeline_id: str = None): @@ -76,7 +80,9 @@ async def mock_load_pipeline_tool(pipeline_id: str = None): @pytest.mark.asyncio async def test_update_pipeline_tool_success(self): """Test successful pipeline update.""" - with patch("src.capabilities.jarvis_handler.update_pipeline") as mock_update: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.update_pipeline" + ) as mock_update: mock_update.return_value = { "pipeline_id": "test_pipeline", "status": "updated", @@ -94,7 +100,9 @@ async def mock_update_pipeline_tool(pipeline_id: str): @pytest.mark.asyncio async def test_build_pipeline_env_tool_success(self): """Test successful pipeline environment building.""" - with patch("src.capabilities.jarvis_handler.build_pipeline_env") as mock_build: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.build_pipeline_env" + ) as mock_build: mock_build.return_value = { "pipeline_id": "test_pipeline", "status": "environment_built", @@ -118,7 +126,9 @@ async def test_get_pkg_config_tool_success(self): "config": {"test_key": "test_value"}, } - with patch("src.capabilities.jarvis_handler.get_pkg_config") as mock_get_config: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.get_pkg_config" + ) as mock_get_config: mock_get_config.return_value = expected_config async def mock_get_pkg_config_tool(pipeline_id: str, pkg_id: str): @@ -132,7 +142,7 @@ async def mock_get_pkg_config_tool(pipeline_id: str, pkg_id: str): @pytest.mark.asyncio async def test_append_pkg_tool_success(self): """Test successful package appending.""" - with patch("src.capabilities.jarvis_handler.append_pkg") as mock_append: + with patch("jarvis_mcp.capabilities.jarvis_handler.append_pkg") as mock_append: mock_append.return_value = { "pipeline_id": "test_pipeline", "appended": "data_loader", @@ -157,7 +167,9 @@ async def mock_append_pkg_tool( @pytest.mark.asyncio async def test_configure_pkg_tool_success(self): """Test successful package configuration.""" - with patch("src.capabilities.jarvis_handler.configure_pkg") as mock_configure: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.configure_pkg" + ) as mock_configure: mock_configure.return_value = { "pipeline_id": "test_pipeline", "configured": "test_pkg", @@ -176,7 +188,7 @@ async def mock_configure_pkg_tool(pipeline_id: str, pkg_id: str, **kwargs): @pytest.mark.asyncio async def test_unlink_pkg_tool_success(self): """Test successful package unlinking.""" - with patch("src.capabilities.jarvis_handler.unlink_pkg") as mock_unlink: + with patch("jarvis_mcp.capabilities.jarvis_handler.unlink_pkg") as mock_unlink: mock_unlink.return_value = { "pipeline_id": "test_pipeline", "unlinked": "test_pkg", @@ -193,7 +205,7 @@ async def mock_unlink_pkg_tool(pipeline_id: str, pkg_id: str): @pytest.mark.asyncio async def test_remove_pkg_tool_success(self): """Test successful package removal.""" - with patch("src.capabilities.jarvis_handler.remove_pkg") as mock_remove: + with patch("jarvis_mcp.capabilities.jarvis_handler.remove_pkg") as mock_remove: mock_remove.return_value = { "pipeline_id": "test_pipeline", "removed": "test_pkg", @@ -210,7 +222,7 @@ async def mock_remove_pkg_tool(pipeline_id: str, pkg_id: str): @pytest.mark.asyncio async def test_run_pipeline_tool_success(self): """Test successful pipeline execution.""" - with patch("src.capabilities.jarvis_handler.run_pipeline") as mock_run: + with patch("jarvis_mcp.capabilities.jarvis_handler.run_pipeline") as mock_run: mock_run.return_value = { "pipeline_id": "test_pipeline", "status": "running", @@ -227,7 +239,9 @@ async def mock_run_pipeline_tool(pipeline_id: str): @pytest.mark.asyncio async def test_destroy_pipeline_tool_success(self): """Test successful pipeline destruction.""" - with patch("src.capabilities.jarvis_handler.destroy_pipeline") as mock_destroy: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.destroy_pipeline" + ) as mock_destroy: mock_destroy.return_value = { "pipeline_id": "test_pipeline", "status": "destroyed", @@ -502,23 +516,25 @@ class TestMainFunction: def test_main_stdio_transport(self): """Test main function with stdio transport.""" - with patch("src.server.mcp.run") as mock_run: - # Import and call main - from src.server import main + with ( + patch("jarvis_mcp.server.mcp.run") as mock_run, + patch("sys.argv", ["jarvis-mcp"]), + ): + from jarvis_mcp.server import main main() # Verify run was called with stdio transport - mock_run.assert_called() + mock_run.assert_called_once_with(transport="stdio") - def test_main_sse_transport(self): - """Test main function with SSE transport.""" + def test_main_http_transport(self): + """Test main function with HTTP transport.""" with ( - patch("src.server.mcp.run") as mock_run, - patch.dict(os.environ, {"MCP_TRANSPORT": "sse"}), + patch("jarvis_mcp.server.mcp.run") as mock_run, + patch.dict(os.environ, {"MCP_TRANSPORT": "http"}), + patch("sys.argv", ["jarvis-mcp"]), ): - # Import and call main - from src.server import main + from jarvis_mcp.server import main main() @@ -527,14 +543,16 @@ def test_main_sse_transport(self): def test_main_default_transport(self): """Test main function with default transport.""" - with patch("src.server.mcp.run") as mock_run: - # Import and call main - from src.server import main + with ( + patch("jarvis_mcp.server.mcp.run") as mock_run, + patch("sys.argv", ["jarvis-mcp"]), + ): + from jarvis_mcp.server import main main() - # Verify run was called - mock_run.assert_called() + # Verify run was called with stdio transport (default) + mock_run.assert_called_once_with(transport="stdio") class TestErrorHandling: @@ -566,7 +584,9 @@ def mock_jm_create_config(config_dir: str, private_dir: str): @pytest.mark.asyncio async def test_pipeline_tool_error_handling(self): """Test error handling in pipeline tools.""" - with patch("src.capabilities.jarvis_handler.create_pipeline") as mock_create: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.create_pipeline" + ) as mock_create: mock_create.side_effect = Exception("Pipeline creation failed") async def mock_create_pipeline_tool(pipeline_id: str): @@ -587,7 +607,9 @@ class TestIntegration: @pytest.fixture def mock_pipeline(self): """Mock pipeline for testing.""" - with patch("src.capabilities.jarvis_handler.Pipeline") as mock_pipeline_class: + with patch( + "jarvis_mcp.capabilities.jarvis_handler.Pipeline" + ) as mock_pipeline_class: mock_instance = Mock() mock_pipeline_class.return_value = mock_instance yield mock_instance @@ -604,10 +626,14 @@ def mock_jarvis_manager(self): async def test_pipeline_lifecycle(self, mock_pipeline): """Test complete pipeline lifecycle.""" with ( - patch("src.capabilities.jarvis_handler.create_pipeline") as mock_create, - patch("src.capabilities.jarvis_handler.append_pkg") as mock_append, - patch("src.capabilities.jarvis_handler.run_pipeline") as mock_run, - patch("src.capabilities.jarvis_handler.destroy_pipeline") as mock_destroy, + patch( + "jarvis_mcp.capabilities.jarvis_handler.create_pipeline" + ) as mock_create, + patch("jarvis_mcp.capabilities.jarvis_handler.append_pkg") as mock_append, + patch("jarvis_mcp.capabilities.jarvis_handler.run_pipeline") as mock_run, + patch( + "jarvis_mcp.capabilities.jarvis_handler.destroy_pipeline" + ) as mock_destroy, ): # Setup mock returns mock_create.return_value = {"pipeline_id": "test", "status": "created"} diff --git a/clio-kit-mcp-servers/jarvis/tests/test_server_direct.py b/clio-kit-mcp-servers/jarvis/tests/test_server_direct.py index 118bd12f..490eb590 100644 --- a/clio-kit-mcp-servers/jarvis/tests/test_server_direct.py +++ b/clio-kit-mcp-servers/jarvis/tests/test_server_direct.py @@ -5,6 +5,8 @@ import pytest from unittest.mock import Mock, patch +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message class TestPipelineToolsDirect: @@ -13,13 +15,13 @@ class TestPipelineToolsDirect: @pytest.mark.asyncio async def test_update_pipeline_tool_direct(self): """Test update_pipeline_tool with mocked handler.""" - with patch("src.server.update_pipeline") as mock_handler: + with patch("jarvis_mcp.server.update_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "status": "updated"} # Import and call after patching - from src.server import update_pipeline_tool + from jarvis_mcp.server import update_pipeline_tool - result = await update_pipeline_tool.fn("test") + result = await update_pipeline_tool("test") assert result["pipeline_id"] == "test" mock_handler.assert_called_once() @@ -27,15 +29,15 @@ async def test_update_pipeline_tool_direct(self): @pytest.mark.asyncio async def test_build_pipeline_env_tool_direct(self): """Test build_pipeline_env_tool with mocked handler.""" - with patch("src.server.build_pipeline_env") as mock_handler: + with patch("jarvis_mcp.server.build_pipeline_env") as mock_handler: mock_handler.return_value = { "pipeline_id": "test", "status": "environment_built", } - from src.server import build_pipeline_env_tool + from jarvis_mcp.server import build_pipeline_env_tool - result = await build_pipeline_env_tool.fn("test") + result = await build_pipeline_env_tool("test") assert result["status"] == "environment_built" mock_handler.assert_called_once() @@ -43,12 +45,12 @@ async def test_build_pipeline_env_tool_direct(self): @pytest.mark.asyncio async def test_create_pipeline_tool_direct(self): """Test create_pipeline_tool with mocked handler.""" - with patch("src.server.create_pipeline") as mock_handler: + with patch("jarvis_mcp.server.create_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": "new", "status": "created"} - from src.server import create_pipeline_tool + from jarvis_mcp.server import create_pipeline_tool - result = await create_pipeline_tool.fn("new") + result = await create_pipeline_tool("new") assert result["pipeline_id"] == "new" mock_handler.assert_called_once() @@ -56,12 +58,12 @@ async def test_create_pipeline_tool_direct(self): @pytest.mark.asyncio async def test_load_pipeline_tool_direct(self): """Test load_pipeline_tool with mocked handler.""" - with patch("src.server.load_pipeline") as mock_handler: + with patch("jarvis_mcp.server.load_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": "loaded", "status": "loaded"} - from src.server import load_pipeline_tool + from jarvis_mcp.server import load_pipeline_tool - result = await load_pipeline_tool.fn("loaded") + result = await load_pipeline_tool("loaded") assert result["status"] == "loaded" mock_handler.assert_called_once() @@ -69,12 +71,12 @@ async def test_load_pipeline_tool_direct(self): @pytest.mark.asyncio async def test_load_pipeline_tool_no_id_direct(self): """Test load_pipeline_tool without ID.""" - with patch("src.server.load_pipeline") as mock_handler: + with patch("jarvis_mcp.server.load_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": None, "status": "loaded"} - from src.server import load_pipeline_tool + from jarvis_mcp.server import load_pipeline_tool - result = await load_pipeline_tool.fn(None) + result = await load_pipeline_tool(None) assert result["status"] == "loaded" mock_handler.assert_called_once() @@ -82,16 +84,16 @@ async def test_load_pipeline_tool_no_id_direct(self): @pytest.mark.asyncio async def test_get_pkg_config_tool_direct(self): """Test get_pkg_config_tool with mocked handler.""" - with patch("src.server.get_pkg_config") as mock_handler: + with patch("jarvis_mcp.server.get_pkg_config") as mock_handler: mock_handler.return_value = { "pipeline_id": "test", "pkg_id": "pkg1", "config": {}, } - from src.server import get_pkg_config_tool + from jarvis_mcp.server import get_pkg_config_tool - result = await get_pkg_config_tool.fn("test", "pkg1") + result = await get_pkg_config_tool("test", "pkg1") assert result["pkg_id"] == "pkg1" mock_handler.assert_called_once() @@ -99,12 +101,12 @@ async def test_get_pkg_config_tool_direct(self): @pytest.mark.asyncio async def test_append_pkg_tool_direct(self): """Test append_pkg_tool with mocked handler.""" - with patch("src.server.append_pkg") as mock_handler: + with patch("jarvis_mcp.server.append_pkg") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "appended": "pkg"} - from src.server import append_pkg_tool + from jarvis_mcp.server import append_pkg_tool - result = await append_pkg_tool.fn("test", "pkg_type") + result = await append_pkg_tool("test", "pkg_type") assert result["appended"] == "pkg" mock_handler.assert_called_once() @@ -112,12 +114,12 @@ async def test_append_pkg_tool_direct(self): @pytest.mark.asyncio async def test_append_pkg_tool_with_args_direct(self): """Test append_pkg_tool with optional args.""" - with patch("src.server.append_pkg") as mock_handler: + with patch("jarvis_mcp.server.append_pkg") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "appended": "pkg"} - from src.server import append_pkg_tool + from jarvis_mcp.server import append_pkg_tool - result = await append_pkg_tool.fn( + result = await append_pkg_tool( "test", "pkg_type", pkg_id="pkg1", @@ -131,12 +133,12 @@ async def test_append_pkg_tool_with_args_direct(self): @pytest.mark.asyncio async def test_configure_pkg_tool_direct(self): """Test configure_pkg_tool with mocked handler.""" - with patch("src.server.configure_pkg") as mock_handler: + with patch("jarvis_mcp.server.configure_pkg") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "configured": "pkg"} - from src.server import configure_pkg_tool + from jarvis_mcp.server import configure_pkg_tool - result = await configure_pkg_tool.fn("test", "pkg") + result = await configure_pkg_tool("test", "pkg") assert result["configured"] == "pkg" mock_handler.assert_called_once() @@ -144,12 +146,12 @@ async def test_configure_pkg_tool_direct(self): @pytest.mark.asyncio async def test_unlink_pkg_tool_direct(self): """Test unlink_pkg_tool with mocked handler.""" - with patch("src.server.unlink_pkg") as mock_handler: + with patch("jarvis_mcp.server.unlink_pkg") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "unlinked": "pkg"} - from src.server import unlink_pkg_tool + from jarvis_mcp.server import unlink_pkg_tool - result = await unlink_pkg_tool.fn("test", "pkg") + result = await unlink_pkg_tool("test", "pkg") assert result["unlinked"] == "pkg" mock_handler.assert_called_once() @@ -157,12 +159,12 @@ async def test_unlink_pkg_tool_direct(self): @pytest.mark.asyncio async def test_remove_pkg_tool_direct(self): """Test remove_pkg_tool with mocked handler.""" - with patch("src.server.remove_pkg") as mock_handler: + with patch("jarvis_mcp.server.remove_pkg") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "removed": "pkg"} - from src.server import remove_pkg_tool + from jarvis_mcp.server import remove_pkg_tool - result = await remove_pkg_tool.fn("test", "pkg") + result = await remove_pkg_tool("test", "pkg") assert result["removed"] == "pkg" mock_handler.assert_called_once() @@ -170,12 +172,12 @@ async def test_remove_pkg_tool_direct(self): @pytest.mark.asyncio async def test_run_pipeline_tool_direct(self): """Test run_pipeline_tool with mocked handler.""" - with patch("src.server.run_pipeline") as mock_handler: + with patch("jarvis_mcp.server.run_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "status": "running"} - from src.server import run_pipeline_tool + from jarvis_mcp.server import run_pipeline_tool - result = await run_pipeline_tool.fn("test") + result = await run_pipeline_tool("test") assert result["status"] == "running" mock_handler.assert_called_once() @@ -183,12 +185,12 @@ async def test_run_pipeline_tool_direct(self): @pytest.mark.asyncio async def test_destroy_pipeline_tool_direct(self): """Test destroy_pipeline_tool with mocked handler.""" - with patch("src.server.destroy_pipeline") as mock_handler: + with patch("jarvis_mcp.server.destroy_pipeline") as mock_handler: mock_handler.return_value = {"pipeline_id": "test", "status": "destroyed"} - from src.server import destroy_pipeline_tool + from jarvis_mcp.server import destroy_pipeline_tool - result = await destroy_pipeline_tool.fn("test") + result = await destroy_pipeline_tool("test") assert result["status"] == "destroyed" mock_handler.assert_called_once() @@ -199,13 +201,13 @@ class TestJarvisManagerToolsDirect: def test_jm_create_config_direct(self): """Test jm_create_config with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.create.return_value = None mock_mgr.save.return_value = None - from src.server import jm_create_config + from jarvis_mcp.server import jm_create_config - result = jm_create_config.fn("/cfg", "/priv", "/share") + result = jm_create_config("/cfg", "/priv", "/share") assert len(result) == 1 assert "initialized" in result[0]["text"].lower() @@ -214,23 +216,22 @@ def test_jm_create_config_direct(self): def test_jm_create_config_error_direct(self): """Test jm_create_config error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.create.side_effect = Exception("Error") - from src.server import jm_create_config + from jarvis_mcp.server import jm_create_config - result = jm_create_config.fn("/cfg", "/priv") - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_create_config("/cfg", "/priv") def test_jm_load_config_direct(self): """Test jm_load_config with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.load.return_value = None - from src.server import jm_load_config + from jarvis_mcp.server import jm_load_config - result = jm_load_config.fn() + result = jm_load_config() assert len(result) == 1 assert "loaded" in result[0]["text"].lower() @@ -238,47 +239,45 @@ def test_jm_load_config_direct(self): def test_jm_load_config_error_direct(self): """Test jm_load_config error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.load.side_effect = Exception("Load error") - from src.server import jm_load_config - - result = jm_load_config.fn() + from jarvis_mcp.server import jm_load_config - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_load_config() def test_jm_save_config_direct(self): """Test jm_save_config with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.save.return_value = None - from src.server import jm_save_config + from jarvis_mcp.server import jm_save_config - result = jm_save_config.fn() + result = jm_save_config() assert "saved" in result[0]["text"].lower() mock_mgr.save.assert_called_once() def test_jm_save_config_error_direct(self): """Test jm_save_config error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.save.side_effect = Exception("Save error") - from src.server import jm_save_config + from jarvis_mcp.server import jm_save_config - result = jm_save_config.fn() - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_save_config() def test_jm_set_hostfile_direct(self): """Test jm_set_hostfile with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.set_hostfile.return_value = None mock_mgr.save.return_value = None - from src.server import jm_set_hostfile + from jarvis_mcp.server import jm_set_hostfile - result = jm_set_hostfile.fn("/path/host") + result = jm_set_hostfile("/path/host") assert "/path/host" in result[0]["text"] mock_mgr.set_hostfile.assert_called_once() @@ -286,46 +285,44 @@ def test_jm_set_hostfile_direct(self): def test_jm_set_hostfile_error_direct(self): """Test jm_set_hostfile error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.set_hostfile.side_effect = Exception("Hostfile error") - from src.server import jm_set_hostfile - - result = jm_set_hostfile.fn("/path") + from jarvis_mcp.server import jm_set_hostfile - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_set_hostfile("/path") def test_jm_bootstrap_from_direct(self): """Test jm_bootstrap_from with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.bootstrap_from.return_value = None - from src.server import jm_bootstrap_from + from jarvis_mcp.server import jm_bootstrap_from - result = jm_bootstrap_from.fn("machine1") + result = jm_bootstrap_from("machine1") assert "machine1" in result[0]["text"].lower() mock_mgr.bootstrap_from.assert_called_once() def test_jm_bootstrap_from_error_direct(self): """Test jm_bootstrap_from error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.bootstrap_from.side_effect = Exception("Bootstrap error") - from src.server import jm_bootstrap_from + from jarvis_mcp.server import jm_bootstrap_from - result = jm_bootstrap_from.fn("machine") - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_bootstrap_from("machine") def test_jm_bootstrap_list_direct(self): """Test jm_bootstrap_list with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.bootstrap_list.return_value = ["m1", "m2"] - from src.server import jm_bootstrap_list + from jarvis_mcp.server import jm_bootstrap_list - result = jm_bootstrap_list.fn() + result = jm_bootstrap_list() assert len(result) == 2 assert result[0]["text"] == "m1" @@ -333,298 +330,285 @@ def test_jm_bootstrap_list_direct(self): def test_jm_bootstrap_list_error_direct(self): """Test jm_bootstrap_list error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.bootstrap_list.side_effect = Exception("List error") - from src.server import jm_bootstrap_list - - result = jm_bootstrap_list.fn() + from jarvis_mcp.server import jm_bootstrap_list - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_bootstrap_list() def test_jm_reset_direct(self): """Test jm_reset with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.reset.return_value = None - from src.server import jm_reset + from jarvis_mcp.server import jm_reset - result = jm_reset.fn() + result = jm_reset() assert "reset" in result[0]["text"].lower() mock_mgr.reset.assert_called_once() def test_jm_reset_error_direct(self): """Test jm_reset error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.reset.side_effect = Exception("Reset error") - from src.server import jm_reset + from jarvis_mcp.server import jm_reset - result = jm_reset.fn() - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_reset() def test_jm_list_pipelines_direct(self): """Test jm_list_pipelines with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.list_pipelines.return_value = ["p1", "p2"] - from src.server import jm_list_pipelines + from jarvis_mcp.server import jm_list_pipelines - result = jm_list_pipelines.fn() + result = jm_list_pipelines() assert len(result) == 2 mock_mgr.list_pipelines.assert_called_once() def test_jm_list_pipelines_error_direct(self): """Test jm_list_pipelines error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.list_pipelines.side_effect = Exception("List error") - from src.server import jm_list_pipelines - - result = jm_list_pipelines.fn() + from jarvis_mcp.server import jm_list_pipelines - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_list_pipelines() def test_jm_cd_direct(self): """Test jm_cd with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.cd.return_value = None mock_mgr.save.return_value = None - from src.server import jm_cd + from jarvis_mcp.server import jm_cd - result = jm_cd.fn("pipe1") + result = jm_cd("pipe1") assert "pipe1" in result[0]["text"] mock_mgr.cd.assert_called_once() def test_jm_cd_error_direct(self): """Test jm_cd error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.cd.side_effect = Exception("CD error") - from src.server import jm_cd + from jarvis_mcp.server import jm_cd - result = jm_cd.fn("pipe") - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_cd("pipe") def test_jm_list_repos_direct(self): """Test jm_list_repos with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.list_repos.return_value = ["repo1", "repo2"] - from src.server import jm_list_repos + from jarvis_mcp.server import jm_list_repos - result = jm_list_repos.fn() + result = jm_list_repos() assert len(result) == 2 mock_mgr.list_repos.assert_called_once() def test_jm_list_repos_error_direct(self): """Test jm_list_repos error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.list_repos.side_effect = Exception("List error") - from src.server import jm_list_repos - - result = jm_list_repos.fn() + from jarvis_mcp.server import jm_list_repos - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_list_repos() def test_jm_add_repo_direct(self): """Test jm_add_repo with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.add_repo.return_value = None mock_mgr.save.return_value = None - from src.server import jm_add_repo + from jarvis_mcp.server import jm_add_repo - result = jm_add_repo.fn("/repo", True) + result = jm_add_repo("/repo", True) assert "/repo" in result[0]["text"] mock_mgr.add_repo.assert_called_once() def test_jm_add_repo_error_direct(self): """Test jm_add_repo error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.add_repo.side_effect = Exception("Add error") - from src.server import jm_add_repo + from jarvis_mcp.server import jm_add_repo - result = jm_add_repo.fn("/repo") - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_add_repo("/repo") def test_jm_remove_repo_direct(self): """Test jm_remove_repo with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.remove_repo.return_value = None mock_mgr.save.return_value = None - from src.server import jm_remove_repo + from jarvis_mcp.server import jm_remove_repo - result = jm_remove_repo.fn("repo1") + result = jm_remove_repo("repo1") assert "repo1" in result[0]["text"] mock_mgr.remove_repo.assert_called_once() def test_jm_remove_repo_error_direct(self): """Test jm_remove_repo error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.remove_repo.side_effect = Exception("Remove error") - from src.server import jm_remove_repo - - result = jm_remove_repo.fn("repo") + from jarvis_mcp.server import jm_remove_repo - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_remove_repo("repo") def test_jm_promote_repo_direct(self): """Test jm_promote_repo with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.promote_repo.return_value = None mock_mgr.save.return_value = None - from src.server import jm_promote_repo + from jarvis_mcp.server import jm_promote_repo - result = jm_promote_repo.fn("repo1") + result = jm_promote_repo("repo1") assert "repo1" in result[0]["text"] mock_mgr.promote_repo.assert_called_once() def test_jm_promote_repo_error_direct(self): """Test jm_promote_repo error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.promote_repo.side_effect = Exception("Promote error") - from src.server import jm_promote_repo + from jarvis_mcp.server import jm_promote_repo - result = jm_promote_repo.fn("repo") - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_promote_repo("repo") def test_jm_get_repo_direct(self): """Test jm_get_repo with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_repo = Mock() mock_repo.__str__ = Mock(return_value="RepoInfo") mock_mgr.get_repo.return_value = mock_repo - from src.server import jm_get_repo + from jarvis_mcp.server import jm_get_repo - result = jm_get_repo.fn("repo1") + result = jm_get_repo("repo1") assert "RepoInfo" in result[0]["text"] mock_mgr.get_repo.assert_called_once() def test_jm_get_repo_error_direct(self): """Test jm_get_repo error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.get_repo.side_effect = Exception("Get error") - from src.server import jm_get_repo - - result = jm_get_repo.fn("repo") + from jarvis_mcp.server import jm_get_repo - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_get_repo("repo") def test_jm_construct_pkg_direct(self): """Test jm_construct_pkg with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_pkg = Mock() mock_pkg.__class__.__name__ = "TestPkg" mock_mgr.construct_pkg.return_value = mock_pkg - from src.server import jm_construct_pkg + from jarvis_mcp.server import jm_construct_pkg - result = jm_construct_pkg.fn("test_type") + result = jm_construct_pkg("test_type") assert "TestPkg" in result[0]["text"] mock_mgr.construct_pkg.assert_called_once() def test_jm_construct_pkg_error_direct(self): """Test jm_construct_pkg error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.construct_pkg.side_effect = Exception("Construct error") - from src.server import jm_construct_pkg - - result = jm_construct_pkg.fn("type") + from jarvis_mcp.server import jm_construct_pkg - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_construct_pkg("type") def test_jm_graph_show_direct(self): """Test jm_graph_show with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_show.return_value = None - from src.server import jm_graph_show + from jarvis_mcp.server import jm_graph_show - result = jm_graph_show.fn() + result = jm_graph_show() assert "Resource graph" in result[0]["text"] mock_mgr.resource_graph_show.assert_called_once() def test_jm_graph_show_error_direct(self): """Test jm_graph_show error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_show.side_effect = Exception("Show error") - from src.server import jm_graph_show + from jarvis_mcp.server import jm_graph_show - result = jm_graph_show.fn() - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_graph_show() def test_jm_graph_build_direct(self): """Test jm_graph_build with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_build.return_value = None - from src.server import jm_graph_build + from jarvis_mcp.server import jm_graph_build - result = jm_graph_build.fn(0.5) + result = jm_graph_build(0.5) assert "built" in result[0]["text"].lower() mock_mgr.resource_graph_build.assert_called_once() def test_jm_graph_build_error_direct(self): """Test jm_graph_build error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_build.side_effect = Exception("Build error") - from src.server import jm_graph_build - - result = jm_graph_build.fn(1.0) + from jarvis_mcp.server import jm_graph_build - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_graph_build(1.0) def test_jm_graph_modify_direct(self): """Test jm_graph_modify with mocked manager.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_modify.return_value = None - from src.server import jm_graph_modify + from jarvis_mcp.server import jm_graph_modify - result = jm_graph_modify.fn(0.75) + result = jm_graph_modify(0.75) assert "modified" in result[0]["text"].lower() mock_mgr.resource_graph_modify.assert_called_once() def test_jm_graph_modify_error_direct(self): """Test jm_graph_modify error handling.""" - with patch("src.server.manager") as mock_mgr: + with patch("jarvis_mcp.server.manager") as mock_mgr: mock_mgr.resource_graph_modify.side_effect = Exception("Modify error") - from src.server import jm_graph_modify + from jarvis_mcp.server import jm_graph_modify - result = jm_graph_modify.fn(1.0) - - assert "Error" in result[0]["text"] + with pytest.raises(ToolError): + jm_graph_modify(1.0) class TestMainFunctionDirect: @@ -632,50 +616,40 @@ class TestMainFunctionDirect: def test_main_stdio_default(self): """Test main() with stdio transport.""" - with patch("src.server.os.getenv", return_value="stdio"): - with patch("src.server.mcp.run") as mock_run: - with patch("src.server.print"): - mock_run.side_effect = [ - None, - KeyboardInterrupt(), - ] # Exit after first call - - from src.server import main - - try: - main() - except KeyboardInterrupt: - pass - - # Should be called at least once - assert mock_run.call_count >= 1 - - def test_main_sse_transport(self): - """Test main() with SSE transport.""" - - def mock_getenv(key, default=None): - values = { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "localhost", - "MCP_SSE_PORT": "9000", - } - return values.get(key, default) - - with patch("src.server.os.getenv", side_effect=mock_getenv): - with patch("src.server.mcp.run") as mock_run: - with patch("src.server.print"): - mock_run.side_effect = KeyboardInterrupt() - - from src.server import main - - try: - main() - except KeyboardInterrupt: - pass - - # Verify SSE was attempted - assert mock_run.call_count >= 1 - call_kwargs = mock_run.call_args[1] - assert call_kwargs["transport"] == "sse" - assert call_kwargs["host"] == "localhost" - assert call_kwargs["port"] == 9000 + with ( + patch("sys.argv", ["jarvis-mcp"]), + patch("jarvis_mcp.server.mcp.run") as mock_run, + ): + from jarvis_mcp.server import main + + main() + + # Should be called with stdio transport (default) + mock_run.assert_called_once_with(transport="stdio") + + +class TestResourceAndPrompt: + """Test the new resource and prompt additions.""" + + def test_jarvis_capabilities_resource(self): + """Test the jarvis capabilities resource.""" + from jarvis_mcp.server import jarvis_capabilities + + result = jarvis_capabilities() + + assert "pipeline_types" in result + assert "streaming" in result["pipeline_types"] + assert "batch" in result["pipeline_types"] + assert "real-time" in result["pipeline_types"] + assert "operations" in result + assert "create" in result["operations"] + assert "destroy" in result["operations"] + + def test_create_pipeline_workflow_prompt(self): + """Test the create pipeline workflow prompt.""" + from jarvis_mcp.server import create_pipeline_workflow + + result = create_pipeline_workflow("my_pipeline") + + assert len(result) == 1 + assert isinstance(result[0], Message) diff --git a/clio-kit-mcp-servers/jarvis/tests/utils.py b/clio-kit-mcp-servers/jarvis/tests/utils.py index 63638f52..923c5f22 100644 --- a/clio-kit-mcp-servers/jarvis/tests/utils.py +++ b/clio-kit-mcp-servers/jarvis/tests/utils.py @@ -518,17 +518,12 @@ class ServerToolTester: @staticmethod async def call_tool_function(tool, *args, **kwargs): - """Call the underlying function of a FastMCP tool.""" - # For FastMCP tools, we need to call the underlying function - if hasattr(tool, "fn"): - # Call the function directly - return ( - await tool.fn(*args, **kwargs) - if asyncio.iscoroutinefunction(tool.fn) - else tool.fn(*args, **kwargs) - ) - elif callable(tool): - # If it's callable directly + """Call the underlying function of a FastMCP tool. + + In FastMCP v3, decorators return the original function, so + tools can be called directly without accessing .fn. + """ + if callable(tool): return ( await tool(*args, **kwargs) if asyncio.iscoroutinefunction(tool) @@ -540,10 +535,12 @@ async def call_tool_function(tool, *args, **kwargs): @staticmethod def call_sync_tool_function(tool, *args, **kwargs): - """Call the underlying function of a synchronous FastMCP tool.""" - if hasattr(tool, "fn"): - return tool.fn(*args, **kwargs) - elif callable(tool): + """Call the underlying function of a synchronous FastMCP tool. + + In FastMCP v3, decorators return the original function, so + tools can be called directly without accessing .fn. + """ + if callable(tool): return tool(*args, **kwargs) else: return {"status": "mocked", "args": args, "kwargs": kwargs} diff --git a/clio-kit-mcp-servers/jarvis/uv.lock b/clio-kit-mcp-servers/jarvis/uv.lock index 6c9fd337..2064be70 100644 --- a/clio-kit-mcp-servers/jarvis/uv.lock +++ b/clio-kit-mcp-servers/jarvis/uv.lock @@ -398,18 +398,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.2" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/cc/2e/8c45ef5b00bd48d7cabbf6f90b7f12df4c232755cd46e6dbc6690f9ac0c5/cyclopts-3.22.2.tar.gz", hash = "sha256:d3495231af6ae86479579777d212ddf77b113200f828badeaf401162ed87227d", size = 74520, upload-time = "2025-07-09T12:21:46.866Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/5b/5939e05d87def1612c494429bee705d6b852fad1d21dd2dee1e3ce39997e/cyclopts-3.22.2-py3-none-any.whl", hash = "sha256:6681b0815fa2de2bccc364468fd25b15aa9617cb505c0b16ca62e2b18a57619e", size = 84578, upload-time = "2025-07-09T12:21:44.878Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -490,27 +491,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -573,7 +580,7 @@ name = "importlib-metadata" version = "8.7.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "zipp", marker = "python_full_version < '3.12'" }, + { name = "zipp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/76/66/650a33bd90f786193e4de4b3ad86ea60b53c89b669a5c7be931fac31cdb0/importlib_metadata-8.7.0.tar.gz", hash = "sha256:d13b81ad223b890aa16c5471f2ac3056cf76c5f10f82d6f9292f0b415f389000", size = 56641, upload-time = "2025-04-27T15:29:01.736Z" } wheels = [ @@ -662,7 +669,7 @@ dev = [ [package.metadata] requires-dist = [ { name = "fastapi" }, - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "jarvis-cd", git = "https://github.com/grc-iit/jarvis-cd.git?rev=main" }, { name = "jarvis-util", git = "https://github.com/grc-iit/jarvis-util.git?rev=main" }, { name = "python-dotenv", specifier = ">=1.0.0" }, @@ -699,6 +706,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.24.0" @@ -773,7 +789,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -787,11 +803,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -1005,6 +1023,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -1136,15 +1167,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1159,19 +1190,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -1849,14 +1867,14 @@ wheels = [ [[package]] name = "typing-inspection" -version = "0.4.0" +version = "0.4.2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/82/5c/e6082df02e215b846b4b8c0b887a64d7d08ffaba30605502639d44c06b82/typing_inspection-0.4.0.tar.gz", hash = "sha256:9765c87de36671694a67904bf2c96e395be9c6439bb6c87b5142569dcdd65122", size = 76222, upload-time = "2025-02-25T17:27:59.638Z" } +sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/31/08/aa4fdfb71f7de5176385bd9e90852eaf6b5d622735020ad600f2bab54385/typing_inspection-0.4.0-py3-none-any.whl", hash = "sha256:50e72559fcd2a6367a19f7a7e610e6afcb9fac940c650290eed893d61386832f", size = 14125, upload-time = "2025-02-25T17:27:57.754Z" }, + { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" }, ] [[package]] @@ -1879,16 +1897,119 @@ wheels = [ [[package]] name = "uvicorn" -version = "0.34.2" +version = "0.41.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "click" }, { name = "h11" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/a6/ae/9bbb19b9e1c450cf9ecaef06463e40234d98d95bf572fab11b4f19ae5ded/uvicorn-0.34.2.tar.gz", hash = "sha256:0e929828f6186353a80b58ea719861d2629d766293b6d19baf086ba31d4f3328", size = 76815, upload-time = "2025-04-19T06:02:50.101Z" } +sdist = { url = "https://files.pythonhosted.org/packages/32/ce/eeb58ae4ac36fe09e3842eb02e0eb676bf2c53ae062b98f1b2531673efdd/uvicorn-0.41.0.tar.gz", hash = "sha256:09d11cf7008da33113824ee5a1c6422d89fbc2ff476540d69a34c87fab8b571a", size = 82633, upload-time = "2026-02-16T23:07:24.1Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/b1/4b/4cef6ce21a2aaca9d852a6e84ef4f135d99fcd74fa75105e2fc0c8308acd/uvicorn-0.34.2-py3-none-any.whl", hash = "sha256:deb49af569084536d269fe0a6d67e3754f104cf03aba7c11c40f01aadf33c403", size = 62483, upload-time = "2025-04-19T06:02:48.42Z" }, + { url = "https://files.pythonhosted.org/packages/83/e4/d04a086285c20886c0daad0e026f250869201013d18f81d9ff5eada73a88/uvicorn-0.41.0-py3-none-any.whl", hash = "sha256:29e35b1d2c36a04b9e180d4007ede3bcb32a85fbdfd6c6aeb3f26839de088187", size = 68783, upload-time = "2026-02-16T23:07:22.357Z" }, +] + +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, ] [[package]] diff --git a/clio-kit-mcp-servers/lmod/.claude-plugin/plugin.json b/clio-kit-mcp-servers/lmod/.claude-plugin/plugin.json new file mode 100644 index 00000000..b6cf290f --- /dev/null +++ b/clio-kit-mcp-servers/lmod/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-lmod", + "description": "Lmod MCP - Environment Module Management for LLMs with comprehensive module operations", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/lmod/.mcp.json b/clio-kit-mcp-servers/lmod/.mcp.json new file mode 100644 index 00000000..e521e4e4 --- /dev/null +++ b/clio-kit-mcp-servers/lmod/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-lmod": { + "command": "uvx", + "args": [ + "clio-kit", + "lmod" + ] + } +} diff --git a/clio-kit-mcp-servers/lmod/README.md b/clio-kit-mcp-servers/lmod/README.md index a5fa8461..8cf54d0d 100644 --- a/clio-kit-mcp-servers/lmod/README.md +++ b/clio-kit-mcp-servers/lmod/README.md @@ -141,79 +141,109 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\lmod run lmod-mcp -- ## Capabilities ### `module_list` -**Description**: List all currently loaded environment modules with their versions and status information. - -**Returns**: dict: Dictionary with list of loaded modules, count, and module status information. +**Description**: List all currently loaded environment modules. +**Hints**: read-only, idempotent +**Tags**: modules, query ### `module_avail` -**Description**: Search for available modules that can be loaded with optional pattern matching and filtering. - -**Parameters**: -- `pattern` (str, optional): Search pattern with wildcards (e.g., 'python*', 'gcc/*') - -**Returns**: dict: Dictionary with available modules matching the search criteria and their descriptions. +**Description**: Search for available modules, optionally filtered by name pattern. +**Hints**: read-only, idempotent +**Tags**: modules, query ### `module_show` -**Description**: Display comprehensive information about a specific module including dependencies and environment changes. - -**Parameters**: -- `module_name` (str): Name of the module (e.g., 'python/3.9.0') - -**Returns**: dict: Dictionary with detailed module information, dependencies, and environment modifications. +**Description**: Display detailed information about a specific module. +**Hints**: read-only, idempotent +**Tags**: modules, query ### `module_load` -**Description**: Load one or more environment modules with automatic dependency resolution and conflict detection. +**Description**: Load one or more environment modules into the current session. +**Tags**: management, modules -**Parameters**: -- `modules` (list): List of module names to load +### `module_unload` +**Description**: Unload one or more currently loaded modules from the environment. +**Tags**: management, modules -**Returns**: dict: Dictionary with loading status, any conflicts detected, and environment changes applied. +### `module_swap` +**Description**: Swap one module for another atomically. +**Tags**: management, modules -### `module_unload` -**Description**: Unload one or more currently loaded modules with dependency checking and cleanup. +### `module_spider` +**Description**: Search the entire module tree comprehensively for matching modules. +**Hints**: read-only, idempotent +**Tags**: modules, query -**Parameters**: -- `modules` (list): List of module names to unload +### `module_save` +**Description**: Save currently loaded modules as a named collection. +**Tags**: management, modules -**Returns**: dict: Dictionary with unloading status and environment restoration information. +### `module_restore` +**Description**: Restore a previously saved module collection. +**Tags**: management, modules -### `module_swap` -**Description**: Atomically swap one module for another, handling dependencies and version conflicts automatically. +### `module_savelist` +**Description**: List all saved module collections. +**Hints**: read-only, idempotent +**Tags**: modules, query -**Parameters**: -- `old_module` (str): Module to unload -- `new_module` (str): Module to load in its place +### Resources -**Returns**: dict: Dictionary with swap operation status and any dependency adjustments made. +- `lmod://status` - Current Lmod module system status. -### `module_spider` -**Description**: Search the entire module tree comprehensively with deep hierarchy exploration and metadata extraction. +### Prompts -**Parameters**: -- `pattern` (str, optional): Search pattern for comprehensive module discovery +- **setup_environment**: Guided workflow for setting up an HPC software environment. +## Claude Code -**Returns**: dict: Dictionary with comprehensive search results including hidden modules and dependency information. +```bash +claude mcp add clio-lmod -- uvx clio-kit lmod +``` -### `module_save` -**Description**: Save the current set of loaded modules as a named collection for reproducible environments. +Or install via the CLIO Kit plugin marketplace: -**Parameters**: -- `collection_name` (str): Name for the saved collection +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-lmod@iowarp-clio-kit +``` +## Claude Desktop -**Returns**: dict: Dictionary with collection save status and included modules list. +Add to your Claude Desktop config (`claude_desktop_config.json`): -### `module_restore` -**Description**: Restore a previously saved module collection with automatic environment configuration. +```json +{ + "mcpServers": { + "clio-lmod": { + "command": "uvx", + "args": [ + "clio-kit", + "lmod" + ] + } + } +} +``` +## Gemini CLI -**Parameters**: -- `collection_name` (str): Name of the collection to restore +Add to `~/.gemini/settings.json`: -**Returns**: dict: Dictionary with restoration status and any conflicts or missing modules. +```json +{ + "mcpServers": { + "clio-lmod": { + "command": "uvx", + "args": [ + "clio-kit", + "lmod" + ] + } + } +} +``` -### `module_savelist` -**Description**: List all saved module collections with creation dates and module counts. +Or install the CLIO Kit extension: -**Returns**: dict: Dictionary with list of saved collections and their metadata information. +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. HPC Development Environment Setup diff --git a/clio-kit-mcp-servers/lmod/pyproject.toml b/clio-kit-mcp-servers/lmod/pyproject.toml index fab678d0..0d38776d 100644 --- a/clio-kit-mcp-servers/lmod/pyproject.toml +++ b/clio-kit-mcp-servers/lmod/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["lmod", "environment-modules", "module-management", "hpc", "scientific-computing", "supercomputing", "cluster-computing", "module-system"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0" ] @@ -21,7 +21,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -lmod-mcp = "server:main" +lmod-mcp = "lmod_mcp.server:main" [tool.uv] dev-dependencies = [ @@ -32,5 +32,13 @@ dev-dependencies = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/lmod_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/lmod/server.json b/clio-kit-mcp-servers/lmod/server.json new file mode 100644 index 00000000..fa2b320a --- /dev/null +++ b/clio-kit-mcp-servers/lmod/server.json @@ -0,0 +1,75 @@ +{ + "name": "io.github.iowarp/lmod-mcp", + "description": "Lmod MCP - Environment Module Management for LLMs with comprehensive module operations", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "lmod" + ] + }, + "tools": [ + { + "name": "module_list", + "description": "List all currently loaded environment modules." + }, + { + "name": "module_avail", + "description": "Search for available modules, optionally filtered by name pattern." + }, + { + "name": "module_show", + "description": "Display detailed information about a specific module." + }, + { + "name": "module_load", + "description": "Load one or more environment modules into the current session." + }, + { + "name": "module_unload", + "description": "Unload one or more currently loaded modules from the environment." + }, + { + "name": "module_swap", + "description": "Swap one module for another atomically." + }, + { + "name": "module_spider", + "description": "Search the entire module tree comprehensively for matching modules." + }, + { + "name": "module_save", + "description": "Save currently loaded modules as a named collection." + }, + { + "name": "module_restore", + "description": "Restore a previously saved module collection." + }, + { + "name": "module_savelist", + "description": "List all saved module collections." + } + ], + "resources": [ + { + "uri": "lmod://status", + "name": "module_system_status", + "description": "Current Lmod module system status." + } + ], + "prompts": [ + { + "name": "setup_environment", + "description": "Guided workflow for setting up an HPC software environment." + } + ], + "tags": [ + "environment-modules", + "hpc", + "lmod", + "system-administration" + ] +} diff --git a/clio-kit-mcp-servers/lmod/src/__init__.py b/clio-kit-mcp-servers/lmod/src/__init__.py deleted file mode 100644 index ab27fd11..00000000 --- a/clio-kit-mcp-servers/lmod/src/__init__.py +++ /dev/null @@ -1,3 +0,0 @@ -"""Lmod MCP server package for environment module management.""" - -__version__ = "0.1.0" diff --git a/clio-kit-mcp-servers/lmod/src/lmod_mcp/__init__.py b/clio-kit-mcp-servers/lmod/src/lmod_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/lmod/src/capabilities/__init__.py b/clio-kit-mcp-servers/lmod/src/lmod_mcp/capabilities/__init__.py similarity index 100% rename from clio-kit-mcp-servers/lmod/src/capabilities/__init__.py rename to clio-kit-mcp-servers/lmod/src/lmod_mcp/capabilities/__init__.py diff --git a/clio-kit-mcp-servers/lmod/src/capabilities/lmod_handler.py b/clio-kit-mcp-servers/lmod/src/lmod_mcp/capabilities/lmod_handler.py similarity index 100% rename from clio-kit-mcp-servers/lmod/src/capabilities/lmod_handler.py rename to clio-kit-mcp-servers/lmod/src/lmod_mcp/capabilities/lmod_handler.py diff --git a/clio-kit-mcp-servers/lmod/src/lmod_mcp/server.py b/clio-kit-mcp-servers/lmod/src/lmod_mcp/server.py new file mode 100644 index 00000000..5060b2bb --- /dev/null +++ b/clio-kit-mcp-servers/lmod/src/lmod_mcp/server.py @@ -0,0 +1,275 @@ +#!/usr/bin/env python3 +""" +Lmod MCP Server for managing environment modules. +Provides tools to search, load, unload, and inspect modules using the Lmod system. +""" + +import os +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +from typing import Optional +from dotenv import load_dotenv +import logging +from .capabilities import lmod_handler + +# Configure logging +logging.basicConfig( + level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" +) +logger = logging.getLogger(__name__) + +# Load environment variables +load_dotenv() + +# Initialize MCP server +mcp: FastMCP = FastMCP( + "lmod", + instructions=( + "Manages Lmod environment modules on HPC systems. " + "Load, unload, swap, and search modules. Save and restore module collections." + ), + list_page_size=10, +) + + +@mcp.tool( + name="module_list", + description="List all currently loaded environment modules.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"modules", "query"}, +) +async def module_list_tool() -> dict: + """List all currently loaded environment modules with their versions and status.""" + result = await lmod_handler.list_loaded_modules() + if not result.get("success"): + raise ToolError(result.get("error", "Failed to list modules")) + return result + + +@mcp.tool( + name="module_avail", + description="Search for available modules, optionally filtered by name pattern.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"modules", "query"}, +) +async def module_avail_tool(pattern: Optional[str] = None) -> dict: + """Search for available modules with optional pattern matching.""" + result = await lmod_handler.search_available_modules(pattern) + if not result.get("success"): + raise ToolError(result.get("error", "Failed to search modules")) + return result + + +@mcp.tool( + name="module_show", + description="Display detailed information about a specific module.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"modules", "query"}, +) +async def module_show_tool(module_name: str) -> dict: + """Show detailed module info including dependencies and environment changes.""" + result = await lmod_handler.show_module_details(module_name) + if not result.get("success"): + raise ToolError(result.get("error", f"Module {module_name} not found")) + return result + + +@mcp.tool( + name="module_load", + description="Load one or more environment modules into the current session.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"modules", "management"}, +) +async def module_load_tool(modules: list[str]) -> dict: + """Load one or more environment modules with dependency resolution.""" + result = await lmod_handler.load_modules(modules) + if not result.get("success"): + failed = [r for r in result.get("results", []) if not r.get("success")] + errors = "; ".join(r.get("error", "unknown error") for r in failed) + raise ToolError(f"Failed to load modules: {errors}") + return result + + +@mcp.tool( + name="module_unload", + description="Unload one or more currently loaded modules from the environment.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"modules", "management"}, +) +async def module_unload_tool(modules: list[str]) -> dict: + """Unload one or more modules, reversing their environment changes.""" + result = await lmod_handler.unload_modules(modules) + if not result.get("success"): + failed = [r for r in result.get("results", []) if not r.get("success")] + errors = "; ".join(r.get("error", "unknown error") for r in failed) + raise ToolError(f"Failed to unload modules: {errors}") + return result + + +@mcp.tool( + name="module_swap", + description="Swap one module for another atomically.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"modules", "management"}, +) +async def module_swap_tool(old_module: str, new_module: str) -> dict: + """Swap one module for another, useful for switching versions.""" + result = await lmod_handler.swap_modules(old_module, new_module) + if not result.get("success"): + raise ToolError( + result.get("error", f"Failed to swap {old_module} with {new_module}") + ) + return result + + +@mcp.tool( + name="module_spider", + description="Search the entire module tree comprehensively for matching modules.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"modules", "query"}, +) +async def module_spider_tool(pattern: Optional[str] = None) -> dict: + """Search the full module tree, showing all versions and variants.""" + result = await lmod_handler.spider_search(pattern) + if not result.get("success"): + raise ToolError(result.get("error", "Failed to run spider search")) + return result + + +@mcp.tool( + name="module_save", + description="Save currently loaded modules as a named collection.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"modules", "management"}, +) +async def module_save_tool(collection_name: str) -> dict: + """Save the current module set as a named collection for later restoration.""" + result = await lmod_handler.save_module_collection(collection_name) + if not result.get("success"): + raise ToolError( + result.get("error", f"Failed to save collection {collection_name}") + ) + return result + + +@mcp.tool( + name="module_restore", + description="Restore a previously saved module collection.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"modules", "management"}, +) +async def module_restore_tool(collection_name: str) -> dict: + """Restore a saved module collection, loading all its modules.""" + result = await lmod_handler.restore_module_collection(collection_name) + if not result.get("success"): + raise ToolError( + result.get("error", f"Failed to restore collection {collection_name}") + ) + return result + + +@mcp.tool( + name="module_savelist", + description="List all saved module collections.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"modules", "query"}, +) +async def module_savelist_tool() -> dict: + """List all saved module collections with their metadata.""" + result = await lmod_handler.list_saved_collections() + if not result.get("success"): + raise ToolError(result.get("error", "Failed to list saved collections")) + return result + + +@mcp.resource("lmod://status") +def module_system_status() -> dict: + """Current Lmod module system status.""" + return { + "system": "lmod", + "description": "Environment module system for HPC", + "operations": [ + "list", + "avail", + "load", + "unload", + "swap", + "save", + "restore", + "spider", + ], + } + + +@mcp.prompt() +def setup_environment(software: str) -> list[Message]: + """Guided workflow for setting up an HPC software environment.""" + return [ + Message( + f"I need to set up an environment for {software}. " + "Search available modules, load the appropriate version, " + "verify it's loaded, and save the collection for future use." + ), + ] + + +def main() -> None: + """Main entry point for the Lmod MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Lmod MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/lmod/src/server.py b/clio-kit-mcp-servers/lmod/src/server.py deleted file mode 100644 index 6e511a08..00000000 --- a/clio-kit-mcp-servers/lmod/src/server.py +++ /dev/null @@ -1,205 +0,0 @@ -#!/usr/bin/env python3 -""" -Lmod MCP Server for managing environment modules. -Provides tools to search, load, unload, and inspect modules using the Lmod system. -""" - -import os -import sys -from fastmcp import FastMCP -from typing import Optional -from dotenv import load_dotenv -import logging -from capabilities import lmod_handler - -# Configure logging -logging.basicConfig( - level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" -) -logger = logging.getLogger(__name__) - -# Ensure project root is on path -sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) - -# Load environment variables -load_dotenv() - -# Initialize MCP server -mcp: FastMCP = FastMCP("LmodMCP") - - -@mcp.tool( - name="module_list", - description="List all currently loaded environment modules. Shows the active modules in your current shell environment.", -) -async def module_list_tool() -> dict: - """ - List all currently loaded environment modules with their versions and status information. - - Returns: - dict: Dictionary with list of loaded modules, count, and module status information. - """ - return await lmod_handler.list_loaded_modules() - - -@mcp.tool( - name="module_avail", - description="Search for available modules that can be loaded. Optionally filter by name pattern (e.g., 'python', 'gcc/*', '*mpi*').", -) -async def module_avail_tool(pattern: Optional[str] = None) -> dict: - """ - Search for available modules that can be loaded with optional pattern matching and filtering. - - Args: - pattern (str, optional): Search pattern with wildcards (e.g., 'python*', 'gcc/*') - - Returns: - dict: Dictionary with available modules matching the search criteria and their descriptions. - """ - return await lmod_handler.search_available_modules(pattern) - - -@mcp.tool( - name="module_show", - description="Display detailed information about a specific module including its description, dependencies, environment variables it sets, and conflicts.", -) -async def module_show_tool(module_name: str) -> dict: - """ - Display comprehensive information about a specific module including dependencies and environment changes. - - Args: - module_name (str): Name of the module (e.g., 'python/3.9.0') - - Returns: - dict: Dictionary with detailed module information, dependencies, and environment modifications. - """ - return await lmod_handler.show_module_details(module_name) - - -@mcp.tool( - name="module_load", - description="Load one or more environment modules into the current session. Modules modify environment variables like PATH, LD_LIBRARY_PATH, etc.", -) -async def module_load_tool(modules: list[str]) -> dict: - """ - Load one or more environment modules with automatic dependency resolution and conflict detection. - - Args: - modules (list): List of module names to load - - Returns: - dict: Dictionary with loading status, any conflicts detected, and environment changes applied. - """ - return await lmod_handler.load_modules(modules) - - -@mcp.tool( - name="module_unload", - description="Unload (remove) one or more currently loaded modules from the environment. Reverses the changes made by module load.", -) -async def module_unload_tool(modules: list[str]) -> dict: - """ - Unload one or more currently loaded modules with dependency checking and cleanup. - - Args: - modules (list): List of module names to unload - - Returns: - dict: Dictionary with unloading status and environment restoration information. - """ - return await lmod_handler.unload_modules(modules) - - -@mcp.tool( - name="module_swap", - description="Swap one module for another (unload old_module and load new_module atomically). Useful for switching between different versions.", -) -async def module_swap_tool(old_module: str, new_module: str) -> dict: - """ - Atomically swap one module for another, handling dependencies and version conflicts automatically. - - Args: - old_module (str): Module to unload - new_module (str): Module to load in its place - - Returns: - dict: Dictionary with swap operation status and any dependency adjustments made. - """ - return await lmod_handler.swap_modules(old_module, new_module) - - -@mcp.tool( - name="module_spider", - description="Search the entire module tree for modules matching a pattern. More comprehensive than module_avail, shows all versions and variants.", -) -async def module_spider_tool(pattern: Optional[str] = None) -> dict: - """ - Search the entire module tree comprehensively with deep hierarchy exploration and metadata extraction. - - Args: - pattern (str, optional): Search pattern for comprehensive module discovery - - Returns: - dict: Dictionary with comprehensive search results including hidden modules and dependency information. - """ - return await lmod_handler.spider_search(pattern) - - -@mcp.tool( - name="module_save", - description="Save the current set of loaded modules as a named collection for easy restoration later.", -) -async def module_save_tool(collection_name: str) -> dict: - """ - Save the current set of loaded modules as a named collection for reproducible environments. - - Args: - collection_name (str): Name for the saved collection - - Returns: - dict: Dictionary with collection save status and included modules list. - """ - return await lmod_handler.save_module_collection(collection_name) - - -@mcp.tool( - name="module_restore", - description="Restore a previously saved module collection, loading all modules that were saved in that collection.", -) -async def module_restore_tool(collection_name: str) -> dict: - """ - Restore a previously saved module collection with automatic environment configuration. - - Args: - collection_name (str): Name of the collection to restore - - Returns: - dict: Dictionary with restoration status and any conflicts or missing modules. - """ - return await lmod_handler.restore_module_collection(collection_name) - - -@mcp.tool( - name="module_savelist", - description="List all saved module collections available for restoration.", -) -async def module_savelist_tool() -> dict: - """ - List all saved module collections with creation dates and module counts. - - Returns: - dict: Dictionary with list of saved collections and their metadata information. - """ - return await lmod_handler.list_saved_collections() - - -def main(): - """Main entry point for the server.""" - import asyncio - - # Run the FastMCP server - asyncio.run(mcp.run()) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/lmod/tests/test_lmod_handler.py b/clio-kit-mcp-servers/lmod/tests/test_lmod_handler.py index 0c0fc235..f6542dc3 100644 --- a/clio-kit-mcp-servers/lmod/tests/test_lmod_handler.py +++ b/clio-kit-mcp-servers/lmod/tests/test_lmod_handler.py @@ -2,11 +2,8 @@ import pytest from unittest.mock import patch -import sys -import os -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) -from capabilities import lmod_handler +from lmod_mcp.capabilities import lmod_handler @pytest.mark.asyncio @@ -14,7 +11,7 @@ async def test_list_loaded_modules_success(): """Test successful listing of loaded modules.""" mock_output = "gcc/11.2.0\npython/3.9.0\n" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.list_loaded_modules() @@ -28,7 +25,7 @@ async def test_list_loaded_modules_success(): @pytest.mark.asyncio async def test_list_loaded_modules_failure(): """Test failed listing of loaded modules.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Error: Module command failed", 1) result = await lmod_handler.list_loaded_modules() @@ -49,7 +46,7 @@ async def test_search_available_modules(): python/3.9.0 """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", mock_output, 0) # module avail outputs to stderr result = await lmod_handler.search_available_modules("python") @@ -76,7 +73,7 @@ async def test_show_module_details(): conflict("python") """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.show_module_details("python/3.9.0") @@ -91,7 +88,7 @@ async def test_show_module_details(): @pytest.mark.asyncio async def test_load_modules(): """Test loading modules.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 0) result = await lmod_handler.load_modules(["gcc/11.2.0", "python/3.9.0"]) @@ -105,7 +102,7 @@ async def test_load_modules(): @pytest.mark.asyncio async def test_load_modules_partial_failure(): """Test loading modules with partial failure.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: # First module succeeds, second fails mock_cmd.side_effect = [("", "", 0), ("", "Module not found", 1)] @@ -119,7 +116,7 @@ async def test_load_modules_partial_failure(): @pytest.mark.asyncio async def test_swap_modules(): """Test swapping modules.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 0) result = await lmod_handler.swap_modules("gcc/10.2.0", "gcc/11.2.0") @@ -143,7 +140,7 @@ async def test_spider_search(): openmpi: 4.1.0, 4.1.1 """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", mock_output, 0) result = await lmod_handler.spider_search() @@ -157,7 +154,7 @@ async def test_spider_search(): @pytest.mark.asyncio async def test_save_module_collection(): """Test saving module collection.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 0) result = await lmod_handler.save_module_collection("my_environment") @@ -172,7 +169,7 @@ async def test_save_module_collection(): @pytest.mark.asyncio async def test_restore_module_collection(): """Test restoring module collection.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: # First call restores, second call lists modules mock_cmd.side_effect = [ ("", "", 0), # restore @@ -195,7 +192,7 @@ async def test_list_saved_collections(): 1) default 2) dev_env 3) prod_env """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.list_saved_collections() @@ -210,7 +207,9 @@ async def test_list_saved_collections(): @pytest.mark.asyncio async def test_module_command_not_found(): """Test handling when module command is not found.""" - with patch("capabilities.lmod_handler.asyncio.create_subprocess_exec") as mock_exec: + with patch( + "lmod_mcp.capabilities.lmod_handler.asyncio.create_subprocess_exec" + ) as mock_exec: mock_exec.side_effect = FileNotFoundError() stdout, stderr, returncode = await lmod_handler._run_module_command(["list"]) @@ -223,7 +222,9 @@ async def test_module_command_not_found(): @pytest.mark.asyncio async def test_module_command_generic_exception(): """Test handling when module command raises generic exception.""" - with patch("capabilities.lmod_handler.asyncio.create_subprocess_exec") as mock_exec: + with patch( + "lmod_mcp.capabilities.lmod_handler.asyncio.create_subprocess_exec" + ) as mock_exec: mock_exec.side_effect = Exception("Generic error") stdout, stderr, returncode = await lmod_handler._run_module_command(["list"]) @@ -236,7 +237,7 @@ async def test_module_command_generic_exception(): @pytest.mark.asyncio async def test_search_available_modules_failure(): """Test search_available_modules when command fails without output.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 1) # Failure with no output result = await lmod_handler.search_available_modules("python") @@ -249,7 +250,7 @@ async def test_search_available_modules_failure(): @pytest.mark.asyncio async def test_show_module_details_failure(): """Test show_module_details when command fails.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Module not found", 1) result = await lmod_handler.show_module_details("nonexistent/1.0") @@ -261,7 +262,7 @@ async def test_show_module_details_failure(): @pytest.mark.asyncio async def test_spider_search_failure(): """Test spider_search when command fails without output.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 1) # Failure with no output result = await lmod_handler.spider_search("python") @@ -274,7 +275,7 @@ async def test_spider_search_failure(): @pytest.mark.asyncio async def test_unload_modules(): """Test unloading modules successfully.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "", 0) # Success result = await lmod_handler.unload_modules(["python/3.9.0", "gcc/11.2.0"]) @@ -297,7 +298,7 @@ def mock_unload_side_effect(args, capture_stderr=False): else: return ("", "Module not loaded", 1) # Failure - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.side_effect = mock_unload_side_effect result = await lmod_handler.unload_modules(["python/3.9.0", "gcc/11.2.0"]) @@ -312,7 +313,7 @@ def mock_unload_side_effect(args, capture_stderr=False): @pytest.mark.asyncio async def test_save_module_collection_failure(): """Test save_module_collection when command fails.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Permission denied", 1) result = await lmod_handler.save_module_collection("test_env") @@ -325,7 +326,7 @@ async def test_save_module_collection_failure(): @pytest.mark.asyncio async def test_restore_module_collection_failure(): """Test restore_module_collection when command fails.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Collection not found", 1) result = await lmod_handler.restore_module_collection("nonexistent") @@ -338,7 +339,7 @@ async def test_restore_module_collection_failure(): @pytest.mark.asyncio async def test_list_saved_collections_failure(): """Test list_saved_collections when command fails.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Command failed", 1) result = await lmod_handler.list_saved_collections() @@ -353,7 +354,7 @@ async def test_list_saved_collections_no_named_collections(): """Test list_saved_collections with no named collections output.""" mock_output = "No named collections" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.list_saved_collections() @@ -373,7 +374,7 @@ async def test_list_saved_collections_simple_names(): prod_env """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.list_saved_collections() @@ -399,7 +400,7 @@ async def test_show_module_details_with_path_and_prereqs(): setenv("PYTHON_ROOT", "/apps/python/3.9.0") """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.show_module_details("python/3.9.0") @@ -422,7 +423,7 @@ async def test_show_module_details_with_tcl_module(): setenv("CC", "gcc") """ - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = (mock_output, "", 0) result = await lmod_handler.show_module_details("gcc/11.2.0") @@ -434,7 +435,7 @@ async def test_show_module_details_with_tcl_module(): @pytest.mark.asyncio async def test_swap_modules_failure(): """Test swap_modules when command fails.""" - with patch("capabilities.lmod_handler._run_module_command") as mock_cmd: + with patch("lmod_mcp.capabilities.lmod_handler._run_module_command") as mock_cmd: mock_cmd.return_value = ("", "Module swap failed", 1) result = await lmod_handler.swap_modules("gcc/10.2.0", "gcc/11.2.0") diff --git a/clio-kit-mcp-servers/lmod/tests/test_server.py b/clio-kit-mcp-servers/lmod/tests/test_server.py index aabec7df..6f101279 100644 --- a/clio-kit-mcp-servers/lmod/tests/test_server.py +++ b/clio-kit-mcp-servers/lmod/tests/test_server.py @@ -2,13 +2,10 @@ import pytest from unittest.mock import patch, AsyncMock -import sys -import os -# Add the src directory to the path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError -import server +from lmod_mcp import server @pytest.mark.asyncio @@ -21,16 +18,34 @@ async def test_module_list_tool(): } with patch( - "server.lmod_handler.list_loaded_modules", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.list_loaded_modules", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_list_tool.fn() + result = await server.module_list_tool() assert result == mock_result mock_handler.assert_called_once() +@pytest.mark.asyncio +async def test_module_list_tool_error(): + """Test module_list tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Module command not found", + "modules": [], + } + + with patch( + "lmod_mcp.server.lmod_handler.list_loaded_modules", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Module command not found"): + await server.module_list_tool() + + @pytest.mark.asyncio async def test_module_avail_tool(): """Test module_avail tool.""" @@ -42,16 +57,30 @@ async def test_module_avail_tool(): } with patch( - "server.lmod_handler.search_available_modules", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.search_available_modules", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_avail_tool.fn(pattern="python") + result = await server.module_avail_tool(pattern="python") assert result == mock_result mock_handler.assert_called_once_with("python") +@pytest.mark.asyncio +async def test_module_avail_tool_error(): + """Test module_avail tool raises ToolError on failure.""" + mock_result = {"success": False, "error": "Failed to search modules", "modules": []} + + with patch( + "lmod_mcp.server.lmod_handler.search_available_modules", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to search modules"): + await server.module_avail_tool(pattern="nonexistent") + + @pytest.mark.asyncio async def test_module_show_tool(): """Test module_show tool.""" @@ -67,16 +96,34 @@ async def test_module_show_tool(): } with patch( - "server.lmod_handler.show_module_details", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.show_module_details", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_show_tool.fn("python/3.9.0") + result = await server.module_show_tool("python/3.9.0") assert result == mock_result mock_handler.assert_called_once_with("python/3.9.0") +@pytest.mark.asyncio +async def test_module_show_tool_error(): + """Test module_show tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Module foo not found", + "module": "foo", + } + + with patch( + "lmod_mcp.server.lmod_handler.show_module_details", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Module foo not found"): + await server.module_show_tool("foo") + + @pytest.mark.asyncio async def test_module_load_tool(): """Test module_load tool.""" @@ -97,16 +144,39 @@ async def test_module_load_tool(): } with patch( - "server.lmod_handler.load_modules", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.load_modules", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_load_tool.fn(["gcc/11.2.0", "python/3.9.0"]) + result = await server.module_load_tool(["gcc/11.2.0", "python/3.9.0"]) assert result == mock_result mock_handler.assert_called_once_with(["gcc/11.2.0", "python/3.9.0"]) +@pytest.mark.asyncio +async def test_module_load_tool_error(): + """Test module_load tool raises ToolError on failure.""" + mock_result = { + "success": False, + "results": [ + { + "module": "bad/1.0", + "success": False, + "error": "Module bad/1.0 not found", + } + ], + } + + with patch( + "lmod_mcp.server.lmod_handler.load_modules", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to load modules"): + await server.module_load_tool(["bad/1.0"]) + + @pytest.mark.asyncio async def test_module_unload_tool(): """Test module_unload tool.""" @@ -122,16 +192,39 @@ async def test_module_unload_tool(): } with patch( - "server.lmod_handler.unload_modules", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.unload_modules", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_unload_tool.fn(["python/3.9.0"]) + result = await server.module_unload_tool(["python/3.9.0"]) assert result == mock_result mock_handler.assert_called_once_with(["python/3.9.0"]) +@pytest.mark.asyncio +async def test_module_unload_tool_error(): + """Test module_unload tool raises ToolError on failure.""" + mock_result = { + "success": False, + "results": [ + { + "module": "notloaded/1.0", + "success": False, + "error": "Module notloaded/1.0 is not loaded", + } + ], + } + + with patch( + "lmod_mcp.server.lmod_handler.unload_modules", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to unload modules"): + await server.module_unload_tool(["notloaded/1.0"]) + + @pytest.mark.asyncio async def test_module_swap_tool(): """Test module_swap tool.""" @@ -143,16 +236,35 @@ async def test_module_swap_tool(): } with patch( - "server.lmod_handler.swap_modules", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.swap_modules", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_swap_tool.fn("gcc/10.2.0", "gcc/11.2.0") + result = await server.module_swap_tool("gcc/10.2.0", "gcc/11.2.0") assert result == mock_result mock_handler.assert_called_once_with("gcc/10.2.0", "gcc/11.2.0") +@pytest.mark.asyncio +async def test_module_swap_tool_error(): + """Test module_swap tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Failed to swap old with new", + "old_module": "old", + "new_module": "new", + } + + with patch( + "lmod_mcp.server.lmod_handler.swap_modules", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to swap old with new"): + await server.module_swap_tool("old", "new") + + @pytest.mark.asyncio async def test_module_spider_tool(): """Test module_spider tool.""" @@ -166,16 +278,34 @@ async def test_module_spider_tool(): } with patch( - "server.lmod_handler.spider_search", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.spider_search", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_spider_tool.fn(pattern=None) + result = await server.module_spider_tool(pattern=None) assert result == mock_result mock_handler.assert_called_once_with(None) +@pytest.mark.asyncio +async def test_module_spider_tool_error(): + """Test module_spider tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Failed to run spider search", + "modules": [], + } + + with patch( + "lmod_mcp.server.lmod_handler.spider_search", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to run spider search"): + await server.module_spider_tool(pattern="bad") + + @pytest.mark.asyncio async def test_module_save_tool(): """Test module_save tool.""" @@ -186,16 +316,34 @@ async def test_module_save_tool(): } with patch( - "server.lmod_handler.save_module_collection", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.save_module_collection", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_save_tool.fn("my_env") + result = await server.module_save_tool("my_env") assert result == mock_result mock_handler.assert_called_once_with("my_env") +@pytest.mark.asyncio +async def test_module_save_tool_error(): + """Test module_save tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Failed to save collection bad_name", + "collection": "bad_name", + } + + with patch( + "lmod_mcp.server.lmod_handler.save_module_collection", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to save collection bad_name"): + await server.module_save_tool("bad_name") + + @pytest.mark.asyncio async def test_module_restore_tool(): """Test module_restore tool.""" @@ -207,16 +355,34 @@ async def test_module_restore_tool(): } with patch( - "server.lmod_handler.restore_module_collection", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.restore_module_collection", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_restore_tool.fn("my_env") + result = await server.module_restore_tool("my_env") assert result == mock_result mock_handler.assert_called_once_with("my_env") +@pytest.mark.asyncio +async def test_module_restore_tool_error(): + """Test module_restore tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Failed to restore collection missing", + "collection": "missing", + } + + with patch( + "lmod_mcp.server.lmod_handler.restore_module_collection", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to restore collection missing"): + await server.module_restore_tool("missing") + + @pytest.mark.asyncio async def test_module_savelist_tool(): """Test module_savelist tool.""" @@ -227,30 +393,48 @@ async def test_module_savelist_tool(): } with patch( - "server.lmod_handler.list_saved_collections", new_callable=AsyncMock + "lmod_mcp.server.lmod_handler.list_saved_collections", new_callable=AsyncMock ) as mock_handler: mock_handler.return_value = mock_result - result = await server.module_savelist_tool.fn() + result = await server.module_savelist_tool() assert result == mock_result mock_handler.assert_called_once() +@pytest.mark.asyncio +async def test_module_savelist_tool_error(): + """Test module_savelist tool raises ToolError on failure.""" + mock_result = { + "success": False, + "error": "Failed to list saved collections", + "collections": [], + } + + with patch( + "lmod_mcp.server.lmod_handler.list_saved_collections", new_callable=AsyncMock + ) as mock_handler: + mock_handler.return_value = mock_result + + with pytest.raises(ToolError, match="Failed to list saved collections"): + await server.module_savelist_tool() + + def test_main_function(): """Test the main function entry point.""" with ( - patch("asyncio.run") as mock_run, + patch("sys.argv", ["lmod-mcp"]), patch.object(server.mcp, "run") as mock_mcp_run, ): server.main() - mock_run.assert_called_once_with(mock_mcp_run.return_value) + mock_mcp_run.assert_called_once_with(transport="stdio") def test_main_module_execution(): """Test __main__ module execution.""" - with patch("server.main") as mock_main: + with patch("lmod_mcp.server.main") as mock_main: # Simulate running the module directly exec( "if __name__ == '__main__': main()", @@ -258,3 +442,21 @@ def test_main_module_execution(): ) mock_main.assert_called_once() + + +def test_module_system_status_resource(): + """Test the lmod://status resource.""" + result = server.module_system_status() + assert result["system"] == "lmod" + assert "list" in result["operations"] + assert "load" in result["operations"] + assert "spider" in result["operations"] + + +def test_setup_environment_prompt(): + """Test the setup_environment prompt.""" + messages = server.setup_environment("tensorflow") + assert len(messages) == 1 + text = messages[0].content.text + assert "tensorflow" in text + assert "Search available modules" in text diff --git a/clio-kit-mcp-servers/lmod/uv.lock b/clio-kit-mcp-servers/lmod/uv.lock index 2a671de1..e86d4191 100644 --- a/clio-kit-mcp-servers/lmod/uv.lock +++ b/clio-kit-mcp-servers/lmod/uv.lock @@ -524,27 +524,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -668,6 +674,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -747,7 +762,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "python-dotenv", specifier = ">=1.0.0" }, ] @@ -773,7 +788,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -787,11 +802,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -824,6 +841,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -871,15 +901,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -894,19 +924,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.23" @@ -1548,16 +1565,119 @@ wheels = [ [[package]] name = "uvicorn" -version = "0.34.3" +version = "0.41.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "click" }, { name = "h11" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/de/ad/713be230bcda622eaa35c28f0d328c3675c371238470abdea52417f17a8e/uvicorn-0.34.3.tar.gz", hash = "sha256:35919a9a979d7a59334b6b10e05d77c1d0d574c50e0fc98b8b1a0f165708b55a", size = 76631, upload-time = "2025-06-01T07:48:17.531Z" } +sdist = { url = "https://files.pythonhosted.org/packages/32/ce/eeb58ae4ac36fe09e3842eb02e0eb676bf2c53ae062b98f1b2531673efdd/uvicorn-0.41.0.tar.gz", hash = "sha256:09d11cf7008da33113824ee5a1c6422d89fbc2ff476540d69a34c87fab8b571a", size = 82633, upload-time = "2026-02-16T23:07:24.1Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/6d/0d/8adfeaa62945f90d19ddc461c55f4a50c258af7662d34b6a3d5d1f8646f6/uvicorn-0.34.3-py3-none-any.whl", hash = "sha256:16246631db62bdfbf069b0645177d6e8a77ba950cfedbfd093acef9444e4d885", size = 62431, upload-time = "2025-06-01T07:48:15.664Z" }, + { url = "https://files.pythonhosted.org/packages/83/e4/d04a086285c20886c0daad0e026f250869201013d18f81d9ff5eada73a88/uvicorn-0.41.0-py3-none-any.whl", hash = "sha256:29e35b1d2c36a04b9e180d4007ede3bcb32a85fbdfd6c6aeb3f26839de088187", size = 68783, upload-time = "2026-02-16T23:07:22.357Z" }, +] + +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, ] [[package]] diff --git a/clio-kit-mcp-servers/ndp/.claude-plugin/plugin.json b/clio-kit-mcp-servers/ndp/.claude-plugin/plugin.json new file mode 100644 index 00000000..0941f7e3 --- /dev/null +++ b/clio-kit-mcp-servers/ndp/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-ndp", + "description": "National Data Platform (NDP) MCP server for searching and discovering datasets across multiple CKAN instances", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/ndp/.mcp.json b/clio-kit-mcp-servers/ndp/.mcp.json new file mode 100644 index 00000000..138ee93d --- /dev/null +++ b/clio-kit-mcp-servers/ndp/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-ndp": { + "command": "uvx", + "args": [ + "clio-kit", + "ndp" + ] + } +} diff --git a/clio-kit-mcp-servers/ndp/README.md b/clio-kit-mcp-servers/ndp/README.md index 57c2cc77..209ca7c6 100644 --- a/clio-kit-mcp-servers/ndp/README.md +++ b/clio-kit-mcp-servers/ndp/README.md @@ -120,45 +120,79 @@ uv run python src/server.py ## Capabilities ### `list_organizations` -**Description**: List organizations from the National Data Platform. - -**Parameters**: -- `name_filter` (str, optional): Filter organizations by name substring match -- `server` (str, optional): Server to query - 'local', 'global', or 'pre_ckan' (default: 'global') - -**Returns**: dict: Contains list of organization names and metadata about the request +**Description**: List organizations available in the National Data Platform. +**Hints**: read-only, idempotent +**Tags**: catalogs, organizations ### `search_datasets` -**Description**: Search for datasets in the National Data Platform using various search criteria. - -**Parameters**: -- `search_terms` (List[str], optional): List of terms for simple search across all fields -- `search_keys` (List[str], optional): Corresponding keys for each search term (use null for global search) -- `dataset_name` (str, optional): Exact or partial dataset name to match -- `dataset_title` (str, optional): Dataset title to search for -- `owner_org` (str, optional): Organization name that owns the dataset -- `resource_url` (str, optional): URL of dataset resource -- `resource_name` (str, optional): Name of dataset resource -- `dataset_description` (str, optional): Text to search in dataset descriptions -- `resource_description` (str, optional): Text to search in resource descriptions -- `resource_format` (str, optional): Resource format (e.g., CSV, JSON, NetCDF) -- `search_term` (str, optional): Comma-separated terms to search across all fields -- `filter_list` (List[str], optional): Field filters in format 'key:value' -- `timestamp` (str, optional): Filter by timestamp field -- `server` (str, optional): Server to search - 'local' or 'global' (default: 'global') -- `limit` (int or str, optional): Maximum number of results to return (default: 20 to prevent context overflow) - -**Returns**: dict: Contains list of matching datasets with detailed metadata +**Description**: Search for datasets in the NDP using term-based or field-specific criteria. +**Hints**: read-only, idempotent +**Tags**: datasets, search ### `get_dataset_details` -**Description**: Get detailed information about a specific dataset. +**Description**: Retrieve detailed metadata for a specific dataset by ID or name. +**Hints**: read-only, idempotent +**Tags**: datasets, metadata + +### Resources + +- `ndp://catalogs` - List of available NDP dataset catalogs. + +### Prompts + +- **explore_datasets**: Guided workflow for discovering and exploring scientific datasets. +## Claude Code + +```bash +claude mcp add clio-ndp -- uvx clio-kit ndp +``` -**Parameters**: -- `dataset_identifier` (str): The dataset ID or name to retrieve details for -- `identifier_type` (str, optional): Type of identifier - 'id' or 'name' (default: 'id') -- `server` (str, optional): Server to query - 'local' or 'global' (default: 'global') +Or install via the CLIO Kit plugin marketplace: -**Returns**: dict: Detailed dataset information including all metadata and resources +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-ndp@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-ndp": { + "command": "uvx", + "args": [ + "clio-kit", + "ndp" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-ndp": { + "command": "uvx", + "args": [ + "clio-kit", + "ndp" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Discover Available Organizations diff --git a/clio-kit-mcp-servers/ndp/pyproject.toml b/clio-kit-mcp-servers/ndp/pyproject.toml index c52bd6bd..b235e655 100644 --- a/clio-kit-mcp-servers/ndp/pyproject.toml +++ b/clio-kit-mcp-servers/ndp/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["ndp", "dataset-search", "ckan", "mcp", "llm-integration", "scientific-data"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "httpx>=0.27.0", "python-dotenv>=1.0.0", "pydantic>=2.5.0", @@ -24,7 +24,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -ndp-mcp = "server:main" +ndp-mcp = "ndp_mcp.server:main" [dependency-groups] dev = [ @@ -38,8 +38,11 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/ndp_mcp"] [tool.ruff] line-length = 100 @@ -47,7 +50,7 @@ target-version = "py310" [tool.ruff.lint] select = ["E", "F", "W", "I", "N", "UP", "S", "B", "A", "C4", "ICN", "PIE", "T20", "Q"] -ignore = ["S101", "S603", "S607"] +ignore = ["S101", "S104", "S603", "S607"] [tool.mypy] python_version = "3.10" @@ -59,7 +62,9 @@ check_untyped_defs = true strict_optional = true [tool.pytest.ini_options] +pythonpath = ["src"] testpaths = ["tests"] +asyncio_mode = "auto" addopts = "--tb=short -v" markers = [ "slow: marks tests as slow (deselect with '-m \"not slow\"')", diff --git a/clio-kit-mcp-servers/ndp/server.json b/clio-kit-mcp-servers/ndp/server.json new file mode 100644 index 00000000..81b4ab46 --- /dev/null +++ b/clio-kit-mcp-servers/ndp/server.json @@ -0,0 +1,47 @@ +{ + "name": "io.github.iowarp/ndp-mcp", + "description": "National Data Platform (NDP) MCP server for searching and discovering datasets across multiple CKAN instances", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "ndp" + ] + }, + "tools": [ + { + "name": "list_organizations", + "description": "List organizations available in the National Data Platform." + }, + { + "name": "search_datasets", + "description": "Search for datasets in the NDP using term-based or field-specific criteria." + }, + { + "name": "get_dataset_details", + "description": "Retrieve detailed metadata for a specific dataset by ID or name." + } + ], + "resources": [ + { + "uri": "ndp://catalogs", + "name": "available_catalogs", + "description": "List of available NDP dataset catalogs." + } + ], + "prompts": [ + { + "name": "explore_datasets", + "description": "Guided workflow for discovering and exploring scientific datasets." + } + ], + "tags": [ + "datasets", + "ckan", + "national-data-platform", + "data-discovery" + ] +} diff --git a/clio-kit-mcp-servers/ndp/src/__init__.py b/clio-kit-mcp-servers/ndp/src/ndp_mcp/__init__.py similarity index 100% rename from clio-kit-mcp-servers/ndp/src/__init__.py rename to clio-kit-mcp-servers/ndp/src/ndp_mcp/__init__.py diff --git a/clio-kit-mcp-servers/ndp/src/server.py b/clio-kit-mcp-servers/ndp/src/ndp_mcp/server.py similarity index 58% rename from clio-kit-mcp-servers/ndp/src/server.py rename to clio-kit-mcp-servers/ndp/src/ndp_mcp/server.py index e2ea758a..9578736d 100644 --- a/clio-kit-mcp-servers/ndp/src/server.py +++ b/clio-kit-mcp-servers/ndp/src/ndp_mcp/server.py @@ -1,20 +1,26 @@ import asyncio -import json import os -import sys -from typing import Any +from typing import Annotated, Any import httpx from dotenv import load_dotenv from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message from pydantic import BaseModel, Field -# Path and environment setup -sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) +# Environment setup load_dotenv() # Initialize FastMCP server instance -mcp: FastMCP = FastMCP("NDPServer") +mcp: FastMCP = FastMCP( + "ndp", + instructions=( + "Discovers and explores scientific datasets from NDP catalogs. " + "Use search_datasets to find data, get_dataset_details for metadata, " + "list_catalogs for available sources." + ), +) class Dataset(BaseModel): @@ -164,31 +170,19 @@ async def search_datasets_advanced( @mcp.tool( name="list_organizations", - description=( # noqa: E501 - "List organizations available in the National Data Platform. This tool should " - "always be called before searching to verify organization names are correctly " - "formatted. Supports filtering by organization name and selecting different " - "servers (local, global, pre_ckan)." - ), + description="List organizations available in the National Data Platform.", + annotations={"readOnlyHint": True, "destructiveHint": False, "idempotentHint": True}, + tags={"organizations", "catalogs"}, ) async def list_organizations( - name_filter: str | None = None, server: str = "global" + name_filter: Annotated[ + str | None, Field(description="Filter organizations by name substring match") + ] = None, + server: Annotated[ + str, Field(description="Server to query: 'local', 'global', or 'pre_ckan'") + ] = "global", ) -> dict[str, Any]: - """ - List organizations from the National Data Platform. - - This tool retrieves a list of all organizations available in the NDP. It's recommended - to call this tool before performing searches to ensure organization names are correctly - formatted and to discover available organizations for filtering search results. - - Args: - name_filter (str, optional): Filter organizations by name substring match - server (str, optional): Server to query - 'local', 'global', or 'pre_ckan' - (default: 'global') - - Returns: - dict: Contains list of organization names and metadata about the request - """ + """List organizations from the National Data Platform.""" try: organizations = await ndp_client.list_organizations(name_filter, server) @@ -200,76 +194,53 @@ async def list_organizations( "_meta": {"tool": "list_organizations", "status": "success"}, } except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "list_organizations", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e @mcp.tool( name="search_datasets", - description=( - "Search for datasets in the National Data Platform using simple or advanced search " - "criteria. Supports both term-based searches and field-specific filtering. Use this " - "tool to discover datasets by keywords, organization, format, or other metadata. " - "Results are automatically limited to 20 by default to prevent context overflow - use " - "the limit parameter to adjust this." - ), + description="Search for datasets in the NDP using term-based or field-specific criteria.", + annotations={"readOnlyHint": True, "destructiveHint": False, "idempotentHint": True}, + tags={"datasets", "search"}, ) async def search_datasets( - search_terms: list[str] | None = None, - search_keys: list[str] | None = None, - dataset_name: str | None = None, - dataset_title: str | None = None, - owner_org: str | None = None, - resource_url: str | None = None, - resource_name: str | None = None, - dataset_description: str | None = None, - resource_description: str | None = None, - resource_format: str | None = None, - search_term: str | None = None, - filter_list: list[str] | None = None, - timestamp: str | None = None, - server: str = "global", - limit: str | int | None = None, + search_terms: Annotated[ + list[str] | None, Field(description="Terms for simple search across all fields") + ] = None, + search_keys: Annotated[ + list[str] | None, Field(description="Corresponding keys for each search term") + ] = None, + dataset_name: Annotated[ + str | None, Field(description="Exact or partial dataset name to match") + ] = None, + dataset_title: Annotated[str | None, Field(description="Dataset title to search for")] = None, + owner_org: Annotated[ + str | None, Field(description="Organization name that owns the dataset") + ] = None, + resource_url: Annotated[str | None, Field(description="URL of dataset resource")] = None, + resource_name: Annotated[str | None, Field(description="Name of dataset resource")] = None, + dataset_description: Annotated[ + str | None, Field(description="Text to search in dataset descriptions") + ] = None, + resource_description: Annotated[ + str | None, Field(description="Text to search in resource descriptions") + ] = None, + resource_format: Annotated[ + str | None, Field(description="Resource format (e.g., CSV, JSON, NetCDF)") + ] = None, + search_term: Annotated[ + str | None, Field(description="Comma-separated terms to search across all fields") + ] = None, + filter_list: Annotated[ + list[str] | None, Field(description="Field filters in format 'key:value'") + ] = None, + timestamp: Annotated[str | None, Field(description="Filter by timestamp field")] = None, + server: Annotated[str, Field(description="Server to search: 'local' or 'global'")] = "global", + limit: Annotated[ + str | int | None, Field(description="Maximum results to return (default: 20)") + ] = None, ) -> dict[str, Any]: - """ - Search for datasets in the National Data Platform using various search criteria. - - This tool provides comprehensive dataset search capabilities with both simple term-based - search and advanced field-specific filtering. When searching by organization, it's - recommended to first call list_organizations to ensure the organization name is - correctly formatted. - - WORKFLOW RECOMMENDATION: - 1. If searching by organization, first call list_organizations to verify organization names - 2. Use simple search (search_terms) for general keyword searches - 3. Use advanced search (specific field parameters) for precise filtering - 4. Consider using limit parameter if expecting large result sets - - Args: - search_terms (List[str], optional): List of terms for simple search across all fields - search_keys (List[str], optional): Corresponding keys for each search term - (use null for global search) - dataset_name (str, optional): Exact or partial dataset name to match - dataset_title (str, optional): Dataset title to search for - owner_org (str, optional): Organization name that owns the dataset - resource_url (str, optional): URL of dataset resource - resource_name (str, optional): Name of dataset resource - dataset_description (str, optional): Text to search in dataset descriptions - resource_description (str, optional): Text to search in resource descriptions - resource_format (str, optional): Resource format (e.g., CSV, JSON, NetCDF) - search_term (str, optional): Comma-separated terms to search across all fields - filter_list (List[str], optional): Field filters in format 'key:value' - timestamp (str, optional): Filter by timestamp field - server (str, optional): Server to search - 'local' or 'global' (default: 'global') - limit (int or str, optional): Maximum number of results to return - (default: 20 to prevent context overflow) - - Returns: - dict: Contains list of matching datasets with detailed metadata - """ + """Search for datasets in the National Data Platform.""" try: # Determine which search method to use if search_terms: @@ -335,70 +306,36 @@ async def search_datasets( "_meta": {"tool": "search_datasets", "status": "success"}, } except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "search_datasets", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e @mcp.tool( name="get_dataset_details", - description=( - "Retrieve detailed information about a specific dataset using its ID or name. Returns " - "comprehensive metadata including all resources, descriptions, and additional fields. " - "Use this after finding datasets with search_datasets to get complete information." - ), + description="Retrieve detailed metadata for a specific dataset by ID or name.", + annotations={"readOnlyHint": True, "destructiveHint": False, "idempotentHint": True}, + tags={"datasets", "metadata"}, ) async def get_dataset_details( - dataset_identifier: str, identifier_type: str = "id", server: str = "global" + dataset_identifier: Annotated[ + str, Field(description="The dataset ID or name to retrieve details for") + ], + identifier_type: Annotated[str, Field(description="Type of identifier: 'id' or 'name'")] = "id", + server: Annotated[str, Field(description="Server to query: 'local' or 'global'")] = "global", ) -> dict[str, Any]: - """ - Get detailed information about a specific dataset. - - This tool retrieves comprehensive information about a dataset using either its - unique ID or name. Use this tool after finding datasets with search_datasets - to get complete details including all resources, metadata, and additional fields. - - Args: - dataset_identifier (str): The dataset ID or name to retrieve details for - identifier_type (str, optional): Type of identifier - 'id' or 'name' (default: 'id') - server (str, optional): Server to query - 'local' or 'global' (default: 'global') - - Returns: - dict: Detailed dataset information including all metadata and resources - """ + """Get detailed information about a specific dataset.""" try: # Search for the specific dataset if identifier_type == "id": - # Search by dataset ID - this would typically be a more specific API call - # For now, we'll use the search functionality datasets = await ndp_client.search_datasets_advanced(server=server) matching_dataset = next((d for d in datasets if d.id == dataset_identifier), None) else: - # Search by dataset name datasets = await ndp_client.search_datasets_advanced( dataset_name=dataset_identifier, server=server ) matching_dataset = next((d for d in datasets if d.name == dataset_identifier), None) if not matching_dataset: - return { - "content": [ - { - "text": json.dumps( - { - "error": ( - f"Dataset not found with {identifier_type}: " - f"{dataset_identifier}" - ) - } - ) - } - ], - "_meta": {"tool": "get_dataset_details", "error": "NotFound"}, - "isError": True, - } + raise ToolError(f"Dataset not found with {identifier_type}: {dataset_identifier}") # Return detailed dataset information dataset_dict = matching_dataset.model_dump() @@ -410,24 +347,48 @@ async def get_dataset_details( "resource_count": len(dataset_dict.get("resources", [])), "_meta": {"tool": "get_dataset_details", "status": "success"}, } + except ToolError: + raise except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "get_dataset_details", "error": type(e).__name__}, - "isError": True, - } + raise ToolError(str(e)) from e + + +@mcp.resource("ndp://catalogs") +def available_catalogs() -> dict[str, Any]: + """List of available NDP dataset catalogs.""" + return { + "catalogs": ["global", "local", "pre_ckan"], + "description": "Available NDP data catalogs", + } + + +@mcp.prompt() +def explore_datasets(query: str) -> list[Message]: + """Guided workflow for discovering and exploring scientific datasets.""" + return [ + Message( + f"I want to find datasets related to '{query}'. " + "Search available catalogs, show me the top results, " + "and provide details on the most relevant one." + ), + ] def main() -> None: - """Main entry point with transport selection.""" - import sys + """Main entry point for the NDP MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="NDP MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) - if len(sys.argv) > 1 and sys.argv[1] == "--fastapi": - # FastAPI mode for development/testing - mcp.run(transport="fastapi", host="localhost", port=8000) # type: ignore[arg-type] else: - # Standard stdio mode for production - mcp.run(transport="stdio") + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/ndp/tests/conftest.py b/clio-kit-mcp-servers/ndp/tests/conftest.py index a4865dbc..45674370 100644 --- a/clio-kit-mcp-servers/ndp/tests/conftest.py +++ b/clio-kit-mcp-servers/ndp/tests/conftest.py @@ -1,19 +1,8 @@ """Test configuration and fixtures for NDP MCP server tests.""" -import asyncio -from collections.abc import Generator - import pytest -@pytest.fixture(scope="session") -def event_loop() -> Generator[asyncio.AbstractEventLoop, None, None]: - """Create an instance of the default event loop for the test session.""" - loop = asyncio.new_event_loop() - yield loop - loop.close() - - @pytest.fixture def sample_dataset_data(): """Sample dataset data for testing.""" diff --git a/clio-kit-mcp-servers/ndp/tests/test_init.py b/clio-kit-mcp-servers/ndp/tests/test_init.py index a97972da..085bf617 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_init.py +++ b/clio-kit-mcp-servers/ndp/tests/test_init.py @@ -1,9 +1,6 @@ """Tests for package initialization and metadata.""" -import os -import sys - -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +import ndp_mcp class TestPackageMetadata: @@ -11,34 +8,24 @@ class TestPackageMetadata: def test_version_exists(self): """Test that package version is defined.""" - import __init__ as pkg - - assert hasattr(pkg, "__version__") + assert hasattr(ndp_mcp, "__version__") def test_version_format(self): """Test that version follows semantic versioning format.""" - import __init__ as pkg - - version = pkg.__version__ + version = ndp_mcp.__version__ assert isinstance(version, str) assert len(version.split(".")) == 3 def test_version_value(self): """Test that version has expected value.""" - import __init__ as pkg - - assert pkg.__version__ == "1.0.0" + assert ndp_mcp.__version__ == "1.0.0" def test_docstring_exists(self): """Test that package has a docstring.""" - import __init__ as pkg - - assert pkg.__doc__ is not None - assert len(pkg.__doc__) > 0 + assert ndp_mcp.__doc__ is not None + assert len(ndp_mcp.__doc__) > 0 def test_docstring_content(self): """Test that docstring mentions NDP.""" - import __init__ as pkg - - assert "National Data Platform" in pkg.__doc__ or "NDP" in pkg.__doc__ - assert "MCP" in pkg.__doc__ + assert "National Data Platform" in ndp_mcp.__doc__ or "NDP" in ndp_mcp.__doc__ + assert "MCP" in ndp_mcp.__doc__ diff --git a/clio-kit-mcp-servers/ndp/tests/test_main.py b/clio-kit-mcp-servers/ndp/tests/test_main.py index b1ca48f1..379dc747 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_main.py +++ b/clio-kit-mcp-servers/ndp/tests/test_main.py @@ -1,13 +1,9 @@ """Tests for main entry point and CLI functionality.""" -import os -import sys from unittest.mock import patch -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server -from server import main +from ndp_mcp import server +from ndp_mcp.server import main class TestMainFunction: @@ -15,37 +11,47 @@ class TestMainFunction: def test_main_default_stdio_mode(self): """Test main function runs in stdio mode by default.""" - with patch("server.mcp.run") as mock_run: - with patch("sys.argv", ["server.py"]): + with patch("ndp_mcp.server.mcp.run") as mock_run: + with patch("sys.argv", ["ndp-mcp"]): main() mock_run.assert_called_once_with(transport="stdio") - def test_main_fastapi_mode(self): - """Test main function runs in fastapi mode with --fastapi flag.""" - with patch("server.mcp.run") as mock_run: - with patch("sys.argv", ["server.py", "--fastapi"]): + def test_main_stdio_mode_explicit(self): + """Test main function runs in stdio mode with --transport stdio.""" + with patch("ndp_mcp.server.mcp.run") as mock_run: + with patch("sys.argv", ["ndp-mcp", "--transport", "stdio"]): main() - mock_run.assert_called_once_with(transport="fastapi", host="localhost", port=8000) + mock_run.assert_called_once_with(transport="stdio") - def test_main_with_other_args(self): - """Test main function with other command line arguments.""" - with patch("server.mcp.run") as mock_run: - with patch("sys.argv", ["server.py", "--other", "arg"]): + def test_main_http_mode(self): + """Test main function runs in http mode with --transport http.""" + with patch("ndp_mcp.server.mcp.run") as mock_run: + with patch("sys.argv", ["ndp-mcp", "--transport", "http"]): main() - # Should default to stdio mode - mock_run.assert_called_once_with(transport="stdio") + mock_run.assert_called_once_with(transport="http", host="0.0.0.0", port=8000) - def test_main_fastapi_as_second_arg(self): - """Test that --fastapi must be the first argument.""" - with patch("server.mcp.run") as mock_run: - with patch("sys.argv", ["server.py", "--other", "--fastapi"]): + def test_main_custom_host_and_port(self): + """Test main function with custom host and port.""" + with patch("ndp_mcp.server.mcp.run") as mock_run: + with patch( + "sys.argv", + ["ndp-mcp", "--transport", "http", "--host", "localhost", "--port", "9000"], + ): main() - # Should default to stdio mode since --fastapi is not argv[1] - mock_run.assert_called_once_with(transport="stdio") + mock_run.assert_called_once_with(transport="http", host="localhost", port=9000) + + def test_main_env_transport(self): + """Test main function uses MCP_TRANSPORT env var when no --transport flag.""" + with patch("ndp_mcp.server.mcp.run") as mock_run: + with patch("sys.argv", ["ndp-mcp"]): + with patch.dict("os.environ", {"MCP_TRANSPORT": "http"}): + main() + + mock_run.assert_called_once_with(transport="http", host="0.0.0.0", port=8000) class TestModuleExecution: @@ -53,8 +59,7 @@ class TestModuleExecution: def test_main_called_when_run_as_script(self): """Test that main() is called when module is run as script.""" - # This test verifies the if __name__ == "__main__": main() block - with patch("server.main") as mock_main: + with patch("ndp_mcp.server.main") as mock_main: # Simulate running as main module with patch.object(server, "__name__", "__main__"): # Execute the module's main block code @@ -72,7 +77,7 @@ class TestServerInitialization: def test_fastmcp_instance_created(self): """Test that FastMCP instance is properly created.""" assert server.mcp is not None - assert server.mcp.name == "NDPServer" + assert server.mcp.name == "ndp" def test_ndp_client_initialized(self): """Test that NDPClient is initialized at module level.""" @@ -87,7 +92,7 @@ def test_ndp_client_default_base_url(self): def test_dataset_model_available(self): """Test that Dataset model is available in module.""" - from server import Dataset + from ndp_mcp.server import Dataset assert Dataset is not None assert hasattr(Dataset, "model_validate") @@ -95,33 +100,36 @@ def test_dataset_model_available(self): def test_dotenv_loaded(self): """Test that dotenv configuration is loaded.""" - # The module should have loaded dotenv - # We can verify by checking that load_dotenv was called - # This is implicitly tested by module import, but we verify the import exists - import server - assert hasattr(server, "load_dotenv") def test_tools_registered(self): """Test that MCP tools are registered.""" - # Verify that the decorated functions exist assert hasattr(server, "list_organizations") assert hasattr(server, "search_datasets") assert hasattr(server, "get_dataset_details") + def test_resource_registered(self): + """Test that the catalogs resource is registered.""" + assert hasattr(server, "available_catalogs") + assert callable(server.available_catalogs) + + def test_prompt_registered(self): + """Test that the explore_datasets prompt is registered.""" + assert hasattr(server, "explore_datasets") + assert callable(server.explore_datasets) + def test_ndp_client_timeout_configured(self): """Test that NDPClient has timeout configured.""" assert server.ndp_client.timeout is not None - # The timeout should be an httpx.Timeout object assert hasattr(server.ndp_client.timeout, "connect") def test_module_imports(self): """Test that required modules are imported.""" assert server.asyncio is not None - assert server.json is not None assert server.os is not None - assert server.sys is not None assert server.httpx is not None assert server.FastMCP is not None assert server.BaseModel is not None assert server.Field is not None + assert server.ToolError is not None + assert server.Message is not None diff --git a/clio-kit-mcp-servers/ndp/tests/test_mcp_tool_handlers.py b/clio-kit-mcp-servers/ndp/tests/test_mcp_tool_handlers.py index c859f4d4..074fc081 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_mcp_tool_handlers.py +++ b/clio-kit-mcp-servers/ndp/tests/test_mcp_tool_handlers.py @@ -1,34 +1,30 @@ """Comprehensive tests for MCP tool handlers to achieve >90% coverage.""" -import json -import os -import sys from unittest.mock import AsyncMock, patch import pytest +from fastmcp.exceptions import ToolError -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server -from server import Dataset +from ndp_mcp import server +from ndp_mcp.server import Dataset @pytest.fixture def list_organizations_fn(): - """Get the underlying list_organizations function.""" - return server.mcp._tool_manager._tools["list_organizations"].fn + """Get the list_organizations function.""" + return server.list_organizations @pytest.fixture def search_datasets_fn(): - """Get the underlying search_datasets function.""" - return server.mcp._tool_manager._tools["search_datasets"].fn + """Get the search_datasets function.""" + return server.search_datasets @pytest.fixture def get_dataset_details_fn(): - """Get the underlying get_dataset_details function.""" - return server.mcp._tool_manager._tools["get_dataset_details"].fn + """Get the get_dataset_details function.""" + return server.get_dataset_details class TestListOrganizationsTool: @@ -39,7 +35,9 @@ async def test_list_organizations_success(self, list_organizations_fn): """Test successful organization listing.""" mock_orgs = ["nasa", "noaa", "usgs"] - with patch("server.ndp_client.list_organizations", new=AsyncMock(return_value=mock_orgs)): + with patch( + "ndp_mcp.server.ndp_client.list_organizations", new=AsyncMock(return_value=mock_orgs) + ): result = await list_organizations_fn(name_filter="n", server="global") assert result["organizations"] == mock_orgs @@ -54,7 +52,9 @@ async def test_list_organizations_no_filter(self, list_organizations_fn): """Test organization listing without filter.""" mock_orgs = ["nasa", "noaa", "usgs", "epa"] - with patch("server.ndp_client.list_organizations", new=AsyncMock(return_value=mock_orgs)): + with patch( + "ndp_mcp.server.ndp_client.list_organizations", new=AsyncMock(return_value=mock_orgs) + ): result = await list_organizations_fn(server="local") assert result["organizations"] == mock_orgs @@ -66,7 +66,7 @@ async def test_list_organizations_no_filter(self, list_organizations_fn): @pytest.mark.asyncio async def test_list_organizations_empty_result(self, list_organizations_fn): """Test organization listing with empty result.""" - with patch("server.ndp_client.list_organizations", new=AsyncMock(return_value=[])): + with patch("ndp_mcp.server.ndp_client.list_organizations", new=AsyncMock(return_value=[])): result = await list_organizations_fn(name_filter="nonexistent") assert result["organizations"] == [] @@ -79,40 +79,31 @@ async def test_list_organizations_exception_handling(self, list_organizations_fn error_msg = "Network connection failed" with patch( - "server.ndp_client.list_organizations", new=AsyncMock(side_effect=Exception(error_msg)) + "ndp_mcp.server.ndp_client.list_organizations", + new=AsyncMock(side_effect=Exception(error_msg)), ): - result = await list_organizations_fn() - - assert "content" in result - assert "error" in json.loads(result["content"][0]["text"]) - assert error_msg in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["tool"] == "list_organizations" - assert result["_meta"]["error"] == "Exception" - assert result["isError"] is True + with pytest.raises(ToolError, match=error_msg): + await list_organizations_fn() @pytest.mark.asyncio async def test_list_organizations_connection_error(self, list_organizations_fn): """Test connection error handling in list_organizations.""" with patch( - "server.ndp_client.list_organizations", + "ndp_mcp.server.ndp_client.list_organizations", new=AsyncMock(side_effect=ConnectionError("Connection refused")), ): - result = await list_organizations_fn() - - assert result["isError"] is True - assert result["_meta"]["error"] == "ConnectionError" + with pytest.raises(ToolError, match="Connection refused"): + await list_organizations_fn() @pytest.mark.asyncio async def test_list_organizations_timeout_error(self, list_organizations_fn): """Test timeout error handling in list_organizations.""" with patch( - "server.ndp_client.list_organizations", + "ndp_mcp.server.ndp_client.list_organizations", new=AsyncMock(side_effect=TimeoutError("Request timed out")), ): - result = await list_organizations_fn() - - assert result["isError"] is True - assert result["_meta"]["error"] == "TimeoutError" + with pytest.raises(ToolError, match="Request timed out"): + await list_organizations_fn() class TestSearchDatasetsTool: @@ -127,7 +118,8 @@ async def test_search_datasets_simple_search(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn( search_terms=["climate", "weather"], @@ -149,7 +141,8 @@ async def test_search_datasets_simple_without_keys(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"]) @@ -164,7 +157,8 @@ async def test_search_datasets_advanced_search(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn( dataset_name="nasa_climate", @@ -186,7 +180,8 @@ async def test_search_datasets_advanced_all_fields(self, search_datasets_fn): mock_datasets = [] with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn( dataset_name="test", @@ -218,7 +213,8 @@ async def test_search_datasets_with_limit_int(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"], limit=10) @@ -234,7 +230,8 @@ async def test_search_datasets_with_limit_string(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"], limit="5") @@ -249,7 +246,8 @@ async def test_search_datasets_with_invalid_limit(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"], limit="invalid") @@ -264,7 +262,8 @@ async def test_search_datasets_with_zero_limit(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"], limit=0) @@ -279,7 +278,8 @@ async def test_search_datasets_default_limit(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"]) @@ -295,7 +295,8 @@ async def test_search_datasets_no_limiting_needed(self, search_datasets_fn): ] with patch( - "server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=mock_datasets) + "ndp_mcp.server.ndp_client.search_datasets_simple", + new=AsyncMock(return_value=mock_datasets), ): result = await search_datasets_fn(search_terms=["test"]) @@ -308,34 +309,28 @@ async def test_search_datasets_exception_handling(self, search_datasets_fn): error_msg = "Search service unavailable" with patch( - "server.ndp_client.search_datasets_simple", + "ndp_mcp.server.ndp_client.search_datasets_simple", new=AsyncMock(side_effect=Exception(error_msg)), ): - result = await search_datasets_fn(search_terms=["test"]) - - assert "content" in result - assert "error" in json.loads(result["content"][0]["text"]) - assert error_msg in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["tool"] == "search_datasets" - assert result["_meta"]["error"] == "Exception" - assert result["isError"] is True + with pytest.raises(ToolError, match=error_msg): + await search_datasets_fn(search_terms=["test"]) @pytest.mark.asyncio async def test_search_datasets_advanced_exception(self, search_datasets_fn): """Test exception handling in advanced search.""" with patch( - "server.ndp_client.search_datasets_advanced", + "ndp_mcp.server.ndp_client.search_datasets_advanced", new=AsyncMock(side_effect=ValueError("Invalid parameter")), ): - result = await search_datasets_fn(dataset_name="test") - - assert result["isError"] is True - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="Invalid parameter"): + await search_datasets_fn(dataset_name="test") @pytest.mark.asyncio async def test_search_datasets_empty_result(self, search_datasets_fn): """Test search with empty result.""" - with patch("server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=[])): + with patch( + "ndp_mcp.server.ndp_client.search_datasets_simple", new=AsyncMock(return_value=[]) + ): result = await search_datasets_fn(search_terms=["nonexistent"]) assert result["count"] == 0 @@ -358,7 +353,8 @@ async def test_get_dataset_details_by_id(self, get_dataset_details_fn): ) with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): result = await get_dataset_details_fn( dataset_identifier="test-id-123", identifier_type="id", server="global" @@ -383,7 +379,8 @@ async def test_get_dataset_details_by_name(self, get_dataset_details_fn): ) with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): result = await get_dataset_details_fn( dataset_identifier="climate_data", identifier_type="name", server="local" @@ -401,20 +398,13 @@ async def test_get_dataset_details_not_found_by_id(self, get_dataset_details_fn) mock_dataset = Dataset(id="other-id", name="other", title="Other") with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): - result = await get_dataset_details_fn( - dataset_identifier="nonexistent-id", identifier_type="id" - ) - - assert "content" in result - assert "error" in json.loads(result["content"][0]["text"]) - assert ( - "Dataset not found with id: nonexistent-id" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["error"] == "NotFound" - assert result["isError"] is True + with pytest.raises(ToolError, match="Dataset not found with id: nonexistent-id"): + await get_dataset_details_fn( + dataset_identifier="nonexistent-id", identifier_type="id" + ) @pytest.mark.asyncio async def test_get_dataset_details_not_found_by_name(self, get_dataset_details_fn): @@ -422,29 +412,22 @@ async def test_get_dataset_details_not_found_by_name(self, get_dataset_details_f mock_dataset = Dataset(id="1", name="other_dataset", title="Other") with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): - result = await get_dataset_details_fn( - dataset_identifier="nonexistent_name", identifier_type="name" - ) - - assert result["isError"] is True - assert ( - "Dataset not found with name: nonexistent_name" - in json.loads(result["content"][0]["text"])["error"] - ) - assert result["_meta"]["error"] == "NotFound" + with pytest.raises(ToolError, match="Dataset not found with name: nonexistent_name"): + await get_dataset_details_fn( + dataset_identifier="nonexistent_name", identifier_type="name" + ) @pytest.mark.asyncio async def test_get_dataset_details_empty_search_result(self, get_dataset_details_fn): """Test when search returns empty results.""" - with patch("server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[])): - result = await get_dataset_details_fn( - dataset_identifier="test-id", identifier_type="id" - ) - - assert result["isError"] is True - assert "Dataset not found" in json.loads(result["content"][0]["text"])["error"] + with patch( + "ndp_mcp.server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[]) + ): + with pytest.raises(ToolError, match="Dataset not found"): + await get_dataset_details_fn(dataset_identifier="test-id", identifier_type="id") @pytest.mark.asyncio async def test_get_dataset_details_multiple_resources(self, get_dataset_details_fn): @@ -461,7 +444,8 @@ async def test_get_dataset_details_multiple_resources(self, get_dataset_details_ ) with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): result = await get_dataset_details_fn( dataset_identifier="test-id", identifier_type="id" @@ -480,7 +464,8 @@ async def test_get_dataset_details_no_resources(self, get_dataset_details_fn): ) with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): result = await get_dataset_details_fn( dataset_identifier="test-id", identifier_type="id" @@ -495,19 +480,11 @@ async def test_get_dataset_details_exception_handling(self, get_dataset_details_ error_msg = "Database connection failed" with patch( - "server.ndp_client.search_datasets_advanced", + "ndp_mcp.server.ndp_client.search_datasets_advanced", new=AsyncMock(side_effect=Exception(error_msg)), ): - result = await get_dataset_details_fn( - dataset_identifier="test-id", identifier_type="id" - ) - - assert "content" in result - assert "error" in json.loads(result["content"][0]["text"]) - assert error_msg in json.loads(result["content"][0]["text"])["error"] - assert result["_meta"]["tool"] == "get_dataset_details" - assert result["_meta"]["error"] == "Exception" - assert result["isError"] is True + with pytest.raises(ToolError, match=error_msg): + await get_dataset_details_fn(dataset_identifier="test-id", identifier_type="id") @pytest.mark.asyncio async def test_get_dataset_details_with_extras(self, get_dataset_details_fn): @@ -520,7 +497,8 @@ async def test_get_dataset_details_with_extras(self, get_dataset_details_fn): ) with patch( - "server.ndp_client.search_datasets_advanced", new=AsyncMock(return_value=[mock_dataset]) + "ndp_mcp.server.ndp_client.search_datasets_advanced", + new=AsyncMock(return_value=[mock_dataset]), ): result = await get_dataset_details_fn( dataset_identifier="test-id", identifier_type="id" diff --git a/clio-kit-mcp-servers/ndp/tests/test_mcp_tools.py b/clio-kit-mcp-servers/ndp/tests/test_mcp_tools.py index a6e85cb9..0c04c8db 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_mcp_tools.py +++ b/clio-kit-mcp-servers/ndp/tests/test_mcp_tools.py @@ -1,13 +1,7 @@ """Tests for MCP integration and basic functionality.""" -# Import the server module -import os -import sys - -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server -from server import Dataset +from ndp_mcp import server +from ndp_mcp.server import Dataset class TestServerBasics: @@ -15,7 +9,7 @@ class TestServerBasics: def test_server_name(self): """Test that the server has the correct name.""" - assert server.mcp.name == "NDPServer" + assert server.mcp.name == "ndp" def test_dataset_model_validation(self): """Test Dataset pydantic model validation.""" diff --git a/clio-kit-mcp-servers/ndp/tests/test_ndp_client.py b/clio-kit-mcp-servers/ndp/tests/test_ndp_client.py index 7d9265f1..0adf07dc 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_ndp_client.py +++ b/clio-kit-mcp-servers/ndp/tests/test_ndp_client.py @@ -1,17 +1,11 @@ """Tests specifically for the NDPClient class.""" -import os - -# Import the NDPClient -import sys from unittest.mock import AsyncMock, MagicMock, patch import httpx import pytest -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from server import Dataset, NDPClient +from ndp_mcp.server import Dataset, NDPClient class TestNDPClientEdgeCases: diff --git a/clio-kit-mcp-servers/ndp/tests/test_server.py b/clio-kit-mcp-servers/ndp/tests/test_server.py index 6f62cf93..c625ffb0 100644 --- a/clio-kit-mcp-servers/ndp/tests/test_server.py +++ b/clio-kit-mcp-servers/ndp/tests/test_server.py @@ -1,16 +1,10 @@ """Tests for NDP MCP server.""" -import os - -# Import the server module -import sys from unittest.mock import AsyncMock, MagicMock, patch import pytest -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from server import Dataset, NDPClient, mcp +from ndp_mcp.server import Dataset, NDPClient, mcp class TestNDPClient: @@ -115,7 +109,7 @@ class TestServerBasics: def test_server_name(self): """Test that the server has the correct name.""" - assert mcp.name == "NDPServer" + assert mcp.name == "ndp" def test_dataset_model(self): """Test Dataset pydantic model.""" diff --git a/clio-kit-mcp-servers/ndp/uv.lock b/clio-kit-mcp-servers/ndp/uv.lock index 515e15d7..d008abaa 100644 --- a/clio-kit-mcp-servers/ndp/uv.lock +++ b/clio-kit-mcp-servers/ndp/uv.lock @@ -415,18 +415,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.5" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/a3/d5/24c6c894f3833bc93d4944c2064309dfd633c0becf93e16fc79d76edd388/cyclopts-3.22.5.tar.gz", hash = "sha256:fa2450b9840abc41c6aa37af5eaeafc7a1264e08054e3a2fe39d49aa154f592a", size = 74890, upload-time = "2025-07-31T18:18:37.336Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/df/e5/a7b6db64f08cfe065e531ec6b508fa7dac704fab70d05adb5bc0c2c1d1b6/cyclopts-3.22.5-py3-none-any.whl", hash = "sha256:92efb4a094d9812718d7efe0bffa319a19cb661f230dbf24406c18cd8809fb82", size = 84994, upload-time = "2025-07-31T18:18:35.939Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -501,27 +502,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -654,6 +661,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -740,7 +756,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -754,11 +770,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -906,7 +924,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "httpx", specifier = ">=0.27.0" }, { name = "pip", specifier = ">=25.3" }, { name = "pydantic", specifier = ">=2.5.0" }, @@ -936,6 +954,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packageurl-python" version = "0.17.5" @@ -1055,15 +1086,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1078,19 +1109,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "py-serializable" version = "2.1.0" @@ -1786,6 +1804,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d2/e2/dc81b1bd1dcfe91735810265e9d26bc8ec5da45b4c0f6237e286819194c3/uvicorn-0.35.0-py3-none-any.whl", hash = "sha256:197535216b25ff9b785e29a0b79199f55222193d47f820816e7da751e9bc8d4a", size = 66406, upload-time = "2025-06-28T16:15:44.816Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/node-hardware/.claude-plugin/plugin.json b/clio-kit-mcp-servers/node-hardware/.claude-plugin/plugin.json new file mode 100644 index 00000000..c539d545 --- /dev/null +++ b/clio-kit-mcp-servers/node-hardware/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-node-hardware", + "description": "Node Hardware MCP - Comprehensive Hardware Monitoring and System Analysis for LLMs with real-time performance metrics", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/node-hardware/.mcp.json b/clio-kit-mcp-servers/node-hardware/.mcp.json new file mode 100644 index 00000000..8d55f692 --- /dev/null +++ b/clio-kit-mcp-servers/node-hardware/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-node-hardware": { + "command": "uvx", + "args": [ + "clio-kit", + "node-hardware" + ] + } +} diff --git a/clio-kit-mcp-servers/node-hardware/README.md b/clio-kit-mcp-servers/node-hardware/README.md index 897afc64..670aa803 100644 --- a/clio-kit-mcp-servers/node-hardware/README.md +++ b/clio-kit-mcp-servers/node-hardware/README.md @@ -132,70 +132,119 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\node-hardware run no ## Capabilities ### `get_cpu_info` -**Description**: Get comprehensive CPU information including specifications, core configuration, frequency analysis, and performance metrics. - -**Returns**: dict: Structured CPU information with performance insights and optimization recommendations. +**Description**: Get CPU specifications, core counts, frequencies, and per-core usage. +**Hints**: read-only, idempotent +**Tags**: cpu, hardware ### `get_memory_info` -**Description**: Get comprehensive memory information including capacity, usage patterns, and performance characteristics. - -**Returns**: dict: Structured memory information with usage insights and optimization recommendations. +**Description**: Get RAM and swap capacity, usage percentages, and availability. +**Hints**: read-only, idempotent +**Tags**: hardware, memory ### `get_system_info` -**Description**: Get comprehensive system information including operating system details, platform configuration, and system status. - -**Returns**: dict: Structured system information with configuration insights and security recommendations. +**Description**: Get OS details, hostname, uptime, and active users. +**Hints**: read-only, idempotent +**Tags**: hardware, system ### `get_disk_info` -**Description**: Get comprehensive disk information including storage devices, partitions, and I/O performance metrics. - -**Returns**: dict: Structured disk information with performance insights and maintenance recommendations. +**Description**: Get disk partitions, usage statistics, and I/O counters. +**Hints**: read-only, idempotent +**Tags**: disk, hardware ### `get_network_info` -**Description**: Get comprehensive network information including interfaces, connections, and bandwidth analysis. - -**Returns**: dict: Structured network information with performance insights and security recommendations. +**Description**: Get network interfaces, IP addresses, and I/O statistics. +**Hints**: read-only, idempotent +**Tags**: hardware, network ### `get_gpu_info` -**Description**: Get comprehensive GPU information including specifications, memory, and compute capabilities. - -**Returns**: dict: Structured GPU information with performance insights and optimization recommendations. +**Description**: Get GPU model, memory, temperature, and utilization via nvidia-smi/rocm-smi. +**Hints**: read-only, idempotent +**Tags**: gpu, hardware ### `get_sensor_info` -**Description**: Get sensor information including temperature, fan speeds, and thermal data. - -**Returns**: dict: Structured sensor information with thermal insights and health recommendations. +**Description**: Get temperature, fan speed, and battery sensor readings. +**Hints**: read-only, idempotent +**Tags**: hardware, sensor ### `get_process_info` -**Description**: Get process information including running processes and resource usage. - -**Returns**: dict: Structured process information with resource insights and optimization recommendations. +**Description**: Get running processes with CPU, memory, and status details. +**Hints**: read-only, idempotent +**Tags**: hardware, process ### `get_performance_info` -**Description**: Get real-time performance metrics including CPU, memory, and disk usage. - -**Returns**: dict: Structured performance information with bottleneck analysis and optimization recommendations. +**Description**: Get real-time CPU, memory, disk, and network performance metrics. +**Hints**: read-only, idempotent +**Tags**: hardware, performance ### `get_remote_node_info` -**Description**: Get comprehensive remote node hardware and system information via SSH with advanced filtering and intelligent analysis. +**Description**: Collect hardware info from a remote node via SSH. Supports component filtering. +**Hints**: read-only, idempotent +**Tags**: hardware, remote, ssh -**Parameters**: -- `hostname` (str): Target hostname or IP address for remote collection. -- `username` (Optional[str]): SSH username for remote authentication. -- `port` (int): SSH port number for remote connection. -- `ssh_key` (Optional[str]): Path to SSH private key file for authentication. -- `timeout` (int): SSH connection timeout in seconds. -- `components` (Optional[List[str]]): List of specific components to include in collection. -- `exclude_components` (Optional[List[str]]): List of specific components to exclude from collection. -- `include_performance` (bool): Whether to include real-time performance analysis. -- `include_health` (bool): Whether to include health assessment and predictive maintenance insights. +### `health_check` +**Description**: Verify server health and hardware monitoring capability status. +**Hints**: read-only, idempotent +**Tags**: diagnostics, hardware -**Returns**: dict: Comprehensive remote hardware and system analysis, including hardware_data, collection_metadata, performance_analysis, health_assessment, ssh_connection_info, error_information, intelligent_insights, optimization_recommendations, and beautiful_formatting. +### Resources -### `health_check` -**Description**: Perform comprehensive health check and system diagnostics with advanced capability verification. +- `node-hardware://system-info` - Basic system identification info. -**Returns**: dict: Comprehensive health assessment, including server_status, capability_status, system_compatibility, performance_metrics, diagnostic_insights, optimization_recommendations, troubleshooting_guide, predictive_maintenance, security_assessment, and health_summary. +### Prompts + +- **system_health_check**: Guided workflow for a full system health check. +## Claude Code + +```bash +claude mcp add clio-node-hardware -- uvx clio-kit node-hardware +``` + +Or install via the CLIO Kit plugin marketplace: + +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-node-hardware@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-node-hardware": { + "command": "uvx", + "args": [ + "clio-kit", + "node-hardware" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-node-hardware": { + "command": "uvx", + "args": [ + "clio-kit", + "node-hardware" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Local Hardware Overview diff --git a/clio-kit-mcp-servers/node-hardware/pyproject.toml b/clio-kit-mcp-servers/node-hardware/pyproject.toml index ec29e348..0c51def9 100644 --- a/clio-kit-mcp-servers/node-hardware/pyproject.toml +++ b/clio-kit-mcp-servers/node-hardware/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["hardware-monitoring", "system-analysis", "performance-metrics", "node-information", "ssh-monitoring", "remote-hardware", "mcp", "llm-integration", "infrastructure-monitoring", "distributed-systems"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0", "psutil>=5.9.0" ] @@ -22,7 +22,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -node-hardware-mcp = "server:main" +node-hardware-mcp = "node_hardware_mcp.server:main" [dependency-groups] dev = [ @@ -36,5 +36,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/node_hardware_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/node-hardware/server.json b/clio-kit-mcp-servers/node-hardware/server.json new file mode 100644 index 00000000..bbce6040 --- /dev/null +++ b/clio-kit-mcp-servers/node-hardware/server.json @@ -0,0 +1,78 @@ +{ + "name": "io.github.iowarp/node-hardware-mcp", + "description": "Node Hardware MCP - Comprehensive Hardware Monitoring and System Analysis for LLMs with real-time performance metrics", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "node-hardware" + ] + }, + "tools": [ + { + "name": "get_cpu_info", + "description": "Get CPU specifications, core counts, frequencies, and per-core usage." + }, + { + "name": "get_memory_info", + "description": "Get RAM and swap capacity, usage percentages, and availability." + }, + { + "name": "get_system_info", + "description": "Get OS details, hostname, uptime, and active users." + }, + { + "name": "get_disk_info", + "description": "Get disk partitions, usage statistics, and I/O counters." + }, + { + "name": "get_network_info", + "description": "Get network interfaces, IP addresses, and I/O statistics." + }, + { + "name": "get_gpu_info", + "description": "Get GPU model, memory, temperature, and utilization via nvidia-smi/rocm-smi." + }, + { + "name": "get_sensor_info", + "description": "Get temperature, fan speed, and battery sensor readings." + }, + { + "name": "get_process_info", + "description": "Get running processes with CPU, memory, and status details." + }, + { + "name": "get_performance_info", + "description": "Get real-time CPU, memory, disk, and network performance metrics." + }, + { + "name": "get_remote_node_info", + "description": "Collect hardware info from a remote node via SSH. Supports component filtering." + }, + { + "name": "health_check", + "description": "Verify server health and hardware monitoring capability status." + } + ], + "resources": [ + { + "uri": "node-hardware://system-info", + "name": "system_info", + "description": "Basic system identification info." + } + ], + "prompts": [ + { + "name": "system_health_check", + "description": "Guided workflow for a full system health check." + } + ], + "tags": [ + "hardware-monitoring", + "system-info", + "performance" + ] +} diff --git a/clio-kit-mcp-servers/node-hardware/src/__init__.py b/clio-kit-mcp-servers/node-hardware/src/__init__.py deleted file mode 100644 index 08d8dccb..00000000 --- a/clio-kit-mcp-servers/node-hardware/src/__init__.py +++ /dev/null @@ -1 +0,0 @@ -# Node Hardware MCP Server Package diff --git a/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/__init__.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/__init__.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/__init__.py similarity index 100% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/__init__.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/__init__.py diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/cpu_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/cpu_info.py similarity index 100% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/cpu_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/cpu_info.py diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/disk_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/disk_info.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/disk_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/disk_info.py index f83e3876..34d8d94b 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/disk_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/disk_info.py @@ -4,7 +4,7 @@ """ import psutil -from capabilities.utils import format_bytes, format_percentage +from .utils import format_bytes, format_percentage def get_disk_info() -> dict: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/gpu_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/gpu_info.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/gpu_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/gpu_info.py index 9782c2d3..233bf918 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/gpu_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/gpu_info.py @@ -4,7 +4,7 @@ """ from typing import Dict, Any -from capabilities.utils import run_command, check_command_available +from .utils import run_command, check_command_available def get_gpu_info() -> Dict[str, Any]: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/hardware_summary.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/hardware_summary.py similarity index 92% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/hardware_summary.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/hardware_summary.py index 8985d5d8..0f5192de 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/hardware_summary.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/hardware_summary.py @@ -3,11 +3,11 @@ Provides comprehensive hardware summary combining all hardware information. """ -from capabilities.cpu_info import get_cpu_info -from capabilities.memory_info import get_memory_info -from capabilities.disk_info import get_disk_info -from capabilities.network_info import get_network_info -from capabilities.system_info import get_system_info +from .cpu_info import get_cpu_info +from .memory_info import get_memory_info +from .disk_info import get_disk_info +from .network_info import get_network_info +from .system_info import get_system_info def get_hardware_summary() -> dict: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/memory_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/memory_info.py similarity index 97% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/memory_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/memory_info.py index 0d21696a..66ae62d2 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/memory_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/memory_info.py @@ -4,7 +4,7 @@ """ import psutil -from capabilities.utils import format_bytes, format_percentage +from .utils import format_bytes, format_percentage def get_memory_info() -> dict: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/network_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/network_info.py similarity index 99% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/network_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/network_info.py index 422da5c9..645d1328 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/network_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/network_info.py @@ -5,7 +5,7 @@ import psutil from typing import Dict, List, Any -from capabilities.utils import format_bytes +from .utils import format_bytes def get_network_info() -> Dict[str, Any]: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/performance_monitor.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/performance_monitor.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/performance_monitor.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/performance_monitor.py index a21c438a..5bf039c7 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/performance_monitor.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/performance_monitor.py @@ -6,7 +6,7 @@ import psutil import time from typing import Dict, Any -from capabilities.utils import format_bytes, format_percentage +from .utils import format_bytes, format_percentage def monitor_performance(duration: int = 5) -> Dict[str, Any]: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/process_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/process_info.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/process_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/process_info.py index 2c04d995..72218b62 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/process_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/process_info.py @@ -5,7 +5,7 @@ import psutil from typing import Dict, Any -from capabilities.utils import format_bytes, format_percentage +from .utils import format_bytes, format_percentage def get_process_info(limit: int = 10) -> Dict[str, Any]: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/remote_node_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/remote_node_info.py similarity index 96% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/remote_node_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/remote_node_info.py index 6ca0ef45..24b32023 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/remote_node_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/remote_node_info.py @@ -7,15 +7,15 @@ import json import os from typing import Dict, Optional, List -from capabilities.system_info import get_system_info -from capabilities.cpu_info import get_cpu_info -from capabilities.memory_info import get_memory_info -from capabilities.disk_info import get_disk_info -from capabilities.network_info import get_network_info -from capabilities.process_info import get_process_info -from capabilities.hardware_summary import get_hardware_summary -from capabilities.gpu_info import get_gpu_info -from capabilities.sensor_info import get_sensor_info +from .system_info import get_system_info +from .cpu_info import get_cpu_info +from .memory_info import get_memory_info +from .disk_info import get_disk_info +from .network_info import get_network_info +from .process_info import get_process_info +from .hardware_summary import get_hardware_summary +from .gpu_info import get_gpu_info +from .sensor_info import get_sensor_info def get_node_info( diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/sensor_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/sensor_info.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/sensor_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/sensor_info.py index ace93c17..ec642110 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/sensor_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/sensor_info.py @@ -4,7 +4,7 @@ from typing import Dict, Any import psutil -from capabilities.utils import run_command, check_command_available +from .utils import run_command, check_command_available def get_sensor_info() -> Dict[str, Any]: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/system_info.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/system_info.py similarity index 98% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/system_info.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/system_info.py index f96487d8..5f8438a7 100644 --- a/clio-kit-mcp-servers/node-hardware/src/capabilities/system_info.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/system_info.py @@ -6,7 +6,7 @@ import psutil import platform import datetime -from capabilities.utils import get_os_info +from .utils import get_os_info def get_system_info() -> dict: diff --git a/clio-kit-mcp-servers/node-hardware/src/capabilities/utils.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/utils.py similarity index 100% rename from clio-kit-mcp-servers/node-hardware/src/capabilities/utils.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/capabilities/utils.py diff --git a/clio-kit-mcp-servers/node-hardware/src/mcp_handlers.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/mcp_handlers.py similarity index 97% rename from clio-kit-mcp-servers/node-hardware/src/mcp_handlers.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/mcp_handlers.py index d610be91..38486776 100644 --- a/clio-kit-mcp-servers/node-hardware/src/mcp_handlers.py +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/mcp_handlers.py @@ -4,18 +4,18 @@ """ from typing import Optional, List -from utils.output_formatter import create_beautiful_response -from capabilities.cpu_info import get_cpu_info -from capabilities.memory_info import get_memory_info -from capabilities.disk_info import get_disk_info -from capabilities.network_info import get_network_info -from capabilities.system_info import get_system_info -from capabilities.process_info import get_process_info -from capabilities.hardware_summary import get_hardware_summary -from capabilities.performance_monitor import monitor_performance -from capabilities.gpu_info import get_gpu_info -from capabilities.sensor_info import get_sensor_info -from capabilities.remote_node_info import get_node_info, get_remote_node_info +from .utils.output_formatter import create_beautiful_response +from .capabilities.cpu_info import get_cpu_info +from .capabilities.memory_info import get_memory_info +from .capabilities.disk_info import get_disk_info +from .capabilities.network_info import get_network_info +from .capabilities.system_info import get_system_info +from .capabilities.process_info import get_process_info +from .capabilities.hardware_summary import get_hardware_summary +from .capabilities.performance_monitor import monitor_performance +from .capabilities.gpu_info import get_gpu_info +from .capabilities.sensor_info import get_sensor_info +from .capabilities.remote_node_info import get_node_info, get_remote_node_info def cpu_info_handler() -> dict: diff --git a/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/server.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/server.py new file mode 100644 index 00000000..8dc35643 --- /dev/null +++ b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/server.py @@ -0,0 +1,376 @@ +#!/usr/bin/env python3 +""" +Node Hardware MCP Server - System hardware monitoring via the Model Context Protocol. +""" + +import os +import sys +import json +import logging +from typing import Annotated, Optional + +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +from pydantic import Field + +try: + from dotenv import load_dotenv + + load_dotenv() +except ImportError: + print( + "Warning: python-dotenv not available. Environment variables may not be loaded.", + file=sys.stderr, + ) + +from . import mcp_handlers + +# Set up logging +logging.basicConfig( + level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" +) +logger = logging.getLogger(__name__) + +# Initialize FastMCP server instance +mcp: FastMCP = FastMCP( + "node-hardware", + instructions=( + "Monitors system hardware including CPU, memory, disk, network, and GPU. " + "Use individual tools for specific metrics or get a full system overview." + ), + list_page_size=10, +) + + +# Custom exception for hardware monitoring errors +class NodeHardwareMCPError(Exception): + """Custom exception for Node Hardware MCP-related errors""" + + pass + + +# ---- Shared annotation constants ---- +_READ_ONLY_ANNOTATIONS = { + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, +} + +# =============================================================================== +# INDIVIDUAL HARDWARE COMPONENT TOOLS +# =============================================================================== + + +@mcp.tool( + name="get_cpu_info", + description="Get CPU specifications, core counts, frequencies, and per-core usage.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "cpu"}, +) +async def get_cpu_info_tool() -> dict: + """Get CPU specifications, core counts, frequencies, and per-core usage.""" + try: + logger.info("Collecting CPU information") + return mcp_handlers.cpu_info_handler() + except Exception as e: + logger.error(f"CPU information collection error: {e}") + raise ToolError(f"CPU collection failed: {e}") from e + + +@mcp.tool( + name="get_memory_info", + description="Get RAM and swap capacity, usage percentages, and availability.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "memory"}, +) +async def get_memory_info_tool() -> dict: + """Get RAM and swap capacity, usage percentages, and availability.""" + try: + logger.info("Collecting memory information") + return mcp_handlers.memory_info_handler() + except Exception as e: + logger.error(f"Memory information collection error: {e}") + raise ToolError(f"Memory collection failed: {e}") from e + + +@mcp.tool( + name="get_system_info", + description="Get OS details, hostname, uptime, and active users.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "system"}, +) +async def get_system_info_tool() -> dict: + """Get OS details, hostname, uptime, and active users.""" + try: + logger.info("Collecting system information") + return mcp_handlers.system_info_handler() + except Exception as e: + logger.error(f"System information collection error: {e}") + raise ToolError(f"System collection failed: {e}") from e + + +@mcp.tool( + name="get_disk_info", + description="Get disk partitions, usage statistics, and I/O counters.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "disk"}, +) +async def get_disk_info_tool() -> dict: + """Get disk partitions, usage statistics, and I/O counters.""" + try: + logger.info("Collecting disk information") + return mcp_handlers.disk_info_handler() + except Exception as e: + logger.error(f"Disk information collection error: {e}") + raise ToolError(f"Disk collection failed: {e}") from e + + +@mcp.tool( + name="get_network_info", + description="Get network interfaces, IP addresses, and I/O statistics.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "network"}, +) +async def get_network_info_tool() -> dict: + """Get network interfaces, IP addresses, and I/O statistics.""" + try: + logger.info("Collecting network information") + return mcp_handlers.network_info_handler() + except Exception as e: + logger.error(f"Network information collection error: {e}") + raise ToolError(f"Network collection failed: {e}") from e + + +@mcp.tool( + name="get_gpu_info", + description="Get GPU model, memory, temperature, and utilization via nvidia-smi/rocm-smi.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "gpu"}, +) +async def get_gpu_info_tool() -> dict: + """Get GPU model, memory, temperature, and utilization.""" + try: + logger.info("Collecting GPU information") + return mcp_handlers.gpu_info_handler() + except Exception as e: + logger.error(f"GPU information collection error: {e}") + raise ToolError(f"GPU collection failed: {e}") from e + + +@mcp.tool( + name="get_sensor_info", + description="Get temperature, fan speed, and battery sensor readings.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "sensor"}, +) +async def get_sensor_info_tool() -> dict: + """Get temperature, fan speed, and battery sensor readings.""" + try: + logger.info("Collecting sensor information") + return mcp_handlers.sensor_info_handler() + except Exception as e: + logger.error(f"Sensor information collection error: {e}") + raise ToolError(f"Sensor collection failed: {e}") from e + + +@mcp.tool( + name="get_process_info", + description="Get running processes with CPU, memory, and status details.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "process"}, +) +async def get_process_info_tool() -> dict: + """Get running processes with CPU, memory, and status details.""" + try: + logger.info("Collecting process information") + return mcp_handlers.process_info_handler() + except Exception as e: + logger.error(f"Process information collection error: {e}") + raise ToolError(f"Process collection failed: {e}") from e + + +@mcp.tool( + name="get_performance_info", + description="Get real-time CPU, memory, disk, and network performance metrics.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "performance"}, +) +async def get_performance_info_tool() -> dict: + """Get real-time CPU, memory, disk, and network performance metrics.""" + try: + logger.info("Collecting performance information") + return mcp_handlers.performance_monitor_handler() + except Exception as e: + logger.error(f"Performance information collection error: {e}") + raise ToolError(f"Performance collection failed: {e}") from e + + +# =============================================================================== +# REMOTE NODE HARDWARE MONITORING VIA SSH +# =============================================================================== + + +@mcp.tool( + name="get_remote_node_info", + description="Collect hardware info from a remote node via SSH. Supports component filtering.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "remote", "ssh"}, +) +async def get_remote_node_info_tool( + hostname: Annotated[str, Field(description="Target hostname or IP address.")], + username: Annotated[Optional[str], Field(description="SSH username.")] = None, + port: Annotated[int, Field(description="SSH port number.")] = 22, + ssh_key: Annotated[ + Optional[str], Field(description="Path to SSH private key file.") + ] = None, + timeout: Annotated[ + int, Field(description="SSH connection timeout in seconds.") + ] = 30, + components: Annotated[ + Optional[list[str]], + Field(description="Components to include, e.g. ['cpu','memory']."), + ] = None, + exclude_components: Annotated[ + Optional[list[str]], + Field(description="Components to exclude from collection."), + ] = None, + include_performance: Annotated[ + bool, Field(description="Include real-time performance analysis.") + ] = True, + include_health: Annotated[ + bool, Field(description="Include health assessment.") + ] = True, +) -> dict: + """Collect hardware info from a remote node via SSH.""" + try: + logger.info( + f"Collecting remote hardware information from {hostname}: " + f"components={components}, exclude={exclude_components}" + ) + return mcp_handlers.get_remote_node_info_handler( + hostname=hostname, + username=username, + port=port, + ssh_key=ssh_key, + timeout=timeout, + include_filters=components, + exclude_filters=exclude_components, + ) + except Exception as e: + logger.error(f"Remote hardware information collection error: {e}") + raise ToolError(f"Remote hardware collection failed for {hostname}: {e}") from e + + +# =============================================================================== +# SYSTEM HEALTH AND DIAGNOSTICS +# =============================================================================== + + +@mcp.tool( + name="health_check", + description="Verify server health and hardware monitoring capability status.", + annotations=_READ_ONLY_ANNOTATIONS, + tags={"hardware", "diagnostics"}, +) +async def health_check_tool() -> dict: + """Verify server health and hardware monitoring capability status.""" + try: + logger.info("Performing health check") + + health_status = { + "server_status": "healthy", + "timestamp": json.dumps({"timestamp": "2024-01-01T00:00:00Z"}), + "capabilities": { + "get_node_info": "available", + "get_remote_node_info": "available", + "local_collection": "available", + "remote_collection": "available", + "ssh_support": "available", + "component_filtering": "available", + "performance_analysis": "available", + "health_assessment": "available", + "intelligent_insights": "available", + "predictive_maintenance": "available", + }, + "system_compatibility": { + "python_version": sys.version, + "platform": os.name, + "dependencies": "loaded", + "ssh_support": "available", + "hardware_monitoring": "available", + }, + "performance_metrics": { + "response_time": "optimal", + "resource_usage": "efficient", + "collection_speed": "high", + "network_efficiency": "optimized", + }, + "health_indicators": { + "overall_health": "excellent", + "system_stability": "stable", + "performance_status": "optimal", + "security_posture": "secure", + }, + } + + return health_status + except Exception as e: + logger.error(f"Health check error: {e}") + raise ToolError(f"Health check failed: {e}") from e + + +# =============================================================================== +# RESOURCE +# =============================================================================== + + +@mcp.resource("node-hardware://system-info") +def system_info() -> dict: + """Basic system identification info.""" + import platform + + return { + "hostname": platform.node(), + "os": platform.system(), + "architecture": platform.machine(), + "python_version": platform.python_version(), + } + + +# =============================================================================== +# PROMPT +# =============================================================================== + + +@mcp.prompt() +def system_health_check() -> list[Message]: + """Guided workflow for a full system health check.""" + return [ + Message( + "Run a complete system health check. Check CPU usage, memory utilization, " + "disk space, and network status. Report any components that are under stress " + "or running low on resources." + ), + ] + + +def main() -> None: + """Main entry point for the Node Hardware MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Node Hardware MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/node-hardware/src/utils/__init__.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/utils/__init__.py similarity index 100% rename from clio-kit-mcp-servers/node-hardware/src/utils/__init__.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/utils/__init__.py diff --git a/clio-kit-mcp-servers/node-hardware/src/utils/output_formatter.py b/clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/utils/output_formatter.py similarity index 100% rename from clio-kit-mcp-servers/node-hardware/src/utils/output_formatter.py rename to clio-kit-mcp-servers/node-hardware/src/node_hardware_mcp/utils/output_formatter.py diff --git a/clio-kit-mcp-servers/node-hardware/src/server.py b/clio-kit-mcp-servers/node-hardware/src/server.py deleted file mode 100644 index 6b0a494d..00000000 --- a/clio-kit-mcp-servers/node-hardware/src/server.py +++ /dev/null @@ -1,788 +0,0 @@ -#!/usr/bin/env python3 -""" -Node Hardware MCP Server - Comprehensive Hardware Monitoring and System Analysis - -This server provides comprehensive hardware monitoring and system analysis capabilities through -the Model Context Protocol, enabling users to collect detailed hardware information, monitor -system performance, and analyze resource utilization across local and remote systems. - -Following MCP best practices, this server is designed with a workflow-first approach -providing intelligent, contextual assistance for hardware monitoring, system analysis, -and infrastructure management workflows. -""" - -import os -import sys -import json -import logging -from typing import Optional, List - -# Try to import required dependencies with fallbacks -try: - from fastmcp import FastMCP -except ImportError: - print("FastMCP not available. Please install with: uv add fastmcp", file=sys.stderr) - sys.exit(1) - -try: - from dotenv import load_dotenv - - load_dotenv() -except ImportError: - print( - "Warning: python-dotenv not available. Environment variables may not be loaded.", - file=sys.stderr, - ) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Import handlers -import mcp_handlers - -# Set up logging -logging.basicConfig( - level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" -) -logger = logging.getLogger(__name__) - -# Initialize FastMCP server instance -mcp: FastMCP = FastMCP("NodeHardware-MCP-SystemMonitoring") - - -# Custom exception for hardware monitoring errors -class NodeHardwareMCPError(Exception): - """Custom exception for Node Hardware MCP-related errors""" - - pass - - -# ═══════════════════════════════════════════════════════════════════════════════ -# INDIVIDUAL HARDWARE COMPONENT TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="get_cpu_info", - description="""Get comprehensive CPU information including specifications, core configuration, frequency analysis, and performance metrics. - -This tool provides detailed CPU analysis including: -- **CPU Model**: Manufacturer, model name, and architecture details -- **Core Configuration**: Physical and logical core counts with hyperthreading detection -- **Frequency Analysis**: Current, minimum, and maximum CPU frequencies -- **Performance Metrics**: Real-time CPU usage across all cores -- **Cache Information**: L1, L2, and L3 cache sizes and hierarchy -- **Thermal Status**: CPU temperature monitoring (if available) -- **Load Analysis**: System load averages and performance indicators - -**Use Cases**: -- Performance monitoring and bottleneck identification -- System capacity planning and resource allocation -- CPU-intensive workload analysis -- Thermal monitoring and cooling assessment -- Hardware upgrade planning and compatibility checking - -**Returns**: Structured CPU information with performance insights and optimization recommendations.""", -) -async def get_cpu_info_tool() -> dict: - """ - Get comprehensive CPU information including specifications, core configuration, frequency analysis, and performance metrics. - - Returns: - dict: Structured CPU information with performance insights and optimization recommendations. - """ - try: - logger.info("Collecting CPU information") - return mcp_handlers.cpu_info_handler() - except Exception as e: - logger.error(f"CPU information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "CPUCollectionError"}}' - } - ], - "_meta": {"tool": "get_cpu_info", "error": "CPUCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_memory_info", - description="""Get comprehensive memory information including capacity, usage patterns, and performance characteristics. - -This tool provides detailed memory analysis including: -- **Memory Capacity**: Total, available, and used memory in bytes and human-readable format -- **Usage Patterns**: Memory utilization percentages and trends -- **Swap Configuration**: Swap space allocation, usage, and performance impact -- **Memory Types**: RAM specifications, speeds, and configurations -- **Performance Metrics**: Memory bandwidth and latency indicators -- **Health Indicators**: Memory error detection and health status -- **Efficiency Analysis**: Memory optimization recommendations - -**Use Cases**: -- Memory usage monitoring and optimization -- Application memory requirement analysis -- System performance tuning and bottleneck identification -- Memory upgrade planning and capacity assessment -- Memory-intensive workload analysis - -**Returns**: Structured memory information with usage insights and optimization recommendations.""", -) -async def get_memory_info_tool() -> dict: - """ - Get comprehensive memory information including capacity, usage patterns, and performance characteristics. - - Returns: - dict: Structured memory information with usage insights and optimization recommendations. - """ - try: - logger.info("Collecting memory information") - return mcp_handlers.memory_info_handler() - except Exception as e: - logger.error(f"Memory information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "MemoryCollectionError"}}' - } - ], - "_meta": {"tool": "get_memory_info", "error": "MemoryCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_system_info", - description="""Get comprehensive system information including operating system details, platform configuration, and system status. - -This tool provides detailed system analysis including: -- **Operating System**: OS name, version, distribution, and kernel information -- **Platform Details**: Architecture, machine type, and processor information -- **System Status**: Hostname, uptime, boot time, and system load -- **User Management**: Active users, user sessions, and authentication status -- **Configuration**: System configuration files and environment variables -- **Security Status**: Security patches, updates, and vulnerability assessment -- **Platform Information**: Hardware platform, virtualization status, and cloud environment detection - -**Use Cases**: -- System inventory and asset management -- OS compatibility checking and upgrade planning -- Security assessment and patch management -- System configuration documentation -- Platform-specific optimization and tuning - -**Returns**: Structured system information with configuration insights and security recommendations.""", -) -async def get_system_info_tool() -> dict: - """ - Get comprehensive system information including operating system details, platform configuration, and system status. - - Returns: - dict: Structured system information with configuration insights and security recommendations. - """ - try: - logger.info("Collecting system information") - return mcp_handlers.system_info_handler() - except Exception as e: - logger.error(f"System information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "SystemCollectionError"}}' - } - ], - "_meta": {"tool": "get_system_info", "error": "SystemCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_disk_info", - description="""Get comprehensive disk information including storage devices, partitions, and I/O performance metrics. - -This tool provides detailed disk analysis including: -- **Storage Devices**: Physical disk drives, SSDs, and storage controllers -- **Partition Information**: File system types, mount points, and partition layouts -- **Usage Analysis**: Disk space utilization, free space, and growth trends -- **I/O Performance**: Read/write speeds, IOPS, and latency measurements -- **Health Monitoring**: SMART status, error rates, and predictive maintenance -- **File Systems**: File system types, mount options, and performance characteristics -- **Predictive Maintenance**: Disk health indicators and failure prediction - -**Use Cases**: -- Storage capacity planning and management -- Disk performance optimization and bottleneck identification -- Storage upgrade planning and RAID configuration -- Backup strategy development and storage allocation -- Disk health monitoring and predictive maintenance - -**Returns**: Structured disk information with performance insights and maintenance recommendations.""", -) -async def get_disk_info_tool() -> dict: - """ - Get comprehensive disk information including storage devices, partitions, and I/O performance metrics. - - Returns: - dict: Structured disk information with performance insights and maintenance recommendations. - """ - try: - logger.info("Collecting disk information") - return mcp_handlers.disk_info_handler() - except Exception as e: - logger.error(f"Disk information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DiskCollectionError"}}' - } - ], - "_meta": {"tool": "get_disk_info", "error": "DiskCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_network_info", - description="""Get comprehensive network information including interfaces, connections, and bandwidth analysis. - -This tool provides detailed network analysis including: -- **Network Interfaces**: Physical and virtual network interfaces with status -- **IP Configuration**: IP addresses, subnet masks, and routing information -- **Connection Details**: Active connections, protocols, and port usage -- **Bandwidth Analysis**: Network throughput, packet statistics, and performance metrics -- **Protocol Statistics**: TCP/UDP statistics, error rates, and connection states -- **Security Monitoring**: Network security status, firewall rules, and intrusion detection -- **Performance Optimization**: Network optimization recommendations and bottleneck identification - -**Use Cases**: -- Network performance monitoring and troubleshooting -- Network capacity planning and bandwidth optimization -- Network security assessment and monitoring -- Network configuration documentation and management -- Network-intensive application analysis - -**Returns**: Structured network information with performance insights and security recommendations.""", -) -async def get_network_info_tool() -> dict: - """ - Get comprehensive network information including interfaces, connections, and bandwidth analysis. - - Returns: - dict: Structured network information with performance insights and security recommendations. - """ - try: - logger.info("Collecting network information") - return mcp_handlers.network_info_handler() - except Exception as e: - logger.error(f"Network information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "NetworkCollectionError"}}' - } - ], - "_meta": {"tool": "get_network_info", "error": "NetworkCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_gpu_info", - description="""Get comprehensive GPU information including specifications, memory, and compute capabilities. - -This tool provides detailed GPU analysis including: -- **GPU Specifications**: GPU model, architecture, and compute capabilities -- **Memory Analysis**: GPU memory capacity, usage, and bandwidth -- **Thermal Monitoring**: GPU temperature, fan speeds, and thermal management -- **Performance Metrics**: GPU utilization, compute performance, and benchmark scores -- **Driver Information**: GPU driver versions, compatibility, and optimization status -- **Compute Capabilities**: CUDA, OpenCL, and other compute framework support -- **Multi-GPU Configuration**: SLI/CrossFire setups and GPU coordination - -**Use Cases**: -- GPU-intensive workload analysis and optimization -- Machine learning and AI workload planning -- Gaming performance assessment and optimization -- GPU upgrade planning and compatibility checking -- GPU health monitoring and thermal management - -**Returns**: Structured GPU information with performance insights and optimization recommendations.""", -) -async def get_gpu_info_tool() -> dict: - """ - Get comprehensive GPU information including specifications, memory, and compute capabilities. - - Returns: - dict: Structured GPU information with performance insights and optimization recommendations. - """ - try: - logger.info("Collecting GPU information") - return mcp_handlers.gpu_info_handler() - except Exception as e: - logger.error(f"GPU information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "GPUCollectionError"}}' - } - ], - "_meta": {"tool": "get_gpu_info", "error": "GPUCollectionError"}, - "isError": True, - } - - -# @mcp.tool( -# name="get_hardware_summary", -# description="""Get a concise hardware summary with key system specifications and overview. - -# This tool provides a comprehensive hardware overview including: -# - **System Overview**: Hostname, platform, and basic system information -# - **CPU Summary**: Processor model, core count, and basic performance metrics -# - **Memory Summary**: Total memory capacity and basic usage statistics -# - **Storage Summary**: Total storage capacity and basic disk information -# - **Network Summary**: Basic network configuration and connectivity status -# - **GPU Summary**: GPU presence and basic specifications -# - **System Health**: Overall system health indicators and status - -# **Use Cases**: -# - Quick system overview and inventory -# - Hardware specification documentation -# - System comparison and compatibility checking -# - Asset management and hardware tracking -# - Initial system assessment and planning - -# **Returns**: Concise hardware summary with key specifications and system status.""" -# ) -# async def get_hardware_summary_tool() -> dict: -# """Get hardware summary with beautiful formatting.""" -# try: -# logger.info("Collecting hardware summary") -# return mcp_handlers.hardware_summary_handler() -# except Exception as e: -# logger.error(f"Hardware summary collection error: {e}") -# return { -# "content": [{"text": f'{{"success": false, "error": "{str(e)}", "error_type": "SummaryCollectionError"}}'}], -# "_meta": {"tool": "get_hardware_summary", "error": "SummaryCollectionError"}, -# "isError": True -# } - - -@mcp.tool( - name="get_sensor_info", - description="""Get sensor information including temperature, fan speeds, and thermal data. - -This tool provides detailed sensor analysis including: -- **Temperature Sensors**: CPU, GPU, motherboard, and ambient temperature readings -- **Fan Control**: Fan speeds, RPM monitoring, and cooling system status -- **Voltage Monitoring**: Power supply voltages, stability, and efficiency metrics -- **Hardware Health**: Component health indicators and thermal management -- **Thermal Management**: Cooling system performance and thermal throttling status -- **Predictive Maintenance**: Temperature trends and failure prediction -- **Environmental Monitoring**: Ambient conditions and environmental factors - -**Use Cases**: -- Thermal monitoring and cooling system optimization -- Hardware health monitoring and predictive maintenance -- Overclocking and performance tuning -- Environmental monitoring and data center management -- Thermal throttling analysis and optimization - -**Returns**: Structured sensor information with thermal insights and health recommendations.""", -) -async def get_sensor_info_tool() -> dict: - """ - Get sensor information including temperature, fan speeds, and thermal data. - - Returns: - dict: Structured sensor information with thermal insights and health recommendations. - """ - try: - logger.info("Collecting sensor information") - return mcp_handlers.sensor_info_handler() - except Exception as e: - logger.error(f"Sensor information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "SensorCollectionError"}}' - } - ], - "_meta": {"tool": "get_sensor_info", "error": "SensorCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_process_info", - description="""Get process information including running processes and resource usage. - -This tool provides detailed process analysis including: -- **Process List**: All running processes with PIDs and basic information -- **Resource Consumption**: CPU, memory, and I/O usage per process -- **Process Hierarchy**: Parent-child relationships and process trees -- **Performance Metrics**: Process performance indicators and resource utilization -- **System Load Analysis**: Overall system load and process distribution -- **Process States**: Running, sleeping, stopped, and zombie processes -- **Resource Monitoring**: Real-time resource usage tracking and trends - -**Use Cases**: -- Process monitoring and resource optimization -- Performance troubleshooting and bottleneck identification -- System load analysis and capacity planning -- Process management and optimization -- Resource-intensive application analysis - -**Returns**: Structured process information with resource insights and optimization recommendations.""", -) -async def get_process_info_tool() -> dict: - """ - Get process information including running processes and resource usage. - - Returns: - dict: Structured process information with resource insights and optimization recommendations. - """ - try: - logger.info("Collecting process information") - return mcp_handlers.process_info_handler() - except Exception as e: - logger.error(f"Process information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "ProcessCollectionError"}}' - } - ], - "_meta": {"tool": "get_process_info", "error": "ProcessCollectionError"}, - "isError": True, - } - - -@mcp.tool( - name="get_performance_info", - description="""Get real-time performance metrics including CPU, memory, and disk usage. - -This tool provides comprehensive performance analysis including: -- **CPU Performance**: Real-time CPU usage, load averages, and performance metrics -- **Memory Performance**: Memory usage, swap activity, and memory pressure indicators -- **Disk Performance**: Disk I/O rates, latency, and throughput measurements -- **Network Performance**: Network throughput, packet rates, and connection statistics -- **System Load**: Overall system load and performance indicators -- **Bottleneck Analysis**: Performance bottleneck identification and analysis -- **Optimization Recommendations**: Performance optimization suggestions and tuning advice - -**Use Cases**: -- Real-time performance monitoring and alerting -- Performance bottleneck identification and resolution -- System optimization and tuning -- Capacity planning and resource allocation -- Performance benchmarking and comparison - -**Returns**: Structured performance information with bottleneck analysis and optimization recommendations.""", -) -async def get_performance_info_tool() -> dict: - """ - Get real-time performance metrics including CPU, memory, and disk usage. - - Returns: - dict: Structured performance information with bottleneck analysis and optimization recommendations. - """ - try: - logger.info("Collecting performance information") - return mcp_handlers.performance_monitor_handler() - except Exception as e: - logger.error(f"Performance information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "PerformanceCollectionError"}}' - } - ], - "_meta": { - "tool": "get_performance_info", - "error": "PerformanceCollectionError", - }, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# REMOTE NODE HARDWARE MONITORING VIA SSH -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="get_remote_node_info", - description="""Get comprehensive remote node hardware and system information via SSH with advanced filtering and intelligent analysis. - -This powerful tool provides complete remote system analysis by securely connecting to remote nodes via SSH -and collecting information from all hardware and system components with sophisticated filtering capabilities. -It delivers comprehensive specifications with intelligent data organization, performance analysis, and optimization recommendations. - -**Remote Hardware Collection Strategy**: -1. **Secure SSH Connection**: Establishes secure SSH connection with comprehensive authentication support and connection optimization -2. **Remote Discovery**: Automatically detects and analyzes all available remote hardware components -3. **Intelligent Filtering**: Applies sophisticated filtering to focus on specific components or exclude unwanted data -4. **Cross-Component Analysis**: Provides integrated analysis across all remote system subsystems for holistic insights -5. **Network Optimization**: Optimized data collection to minimize network bandwidth usage and connection overhead - -**Available Remote Hardware Components**: -- **cpu**: Remote CPU specifications, core configuration, frequency analysis, cache hierarchy, performance metrics, thermal status -- **memory**: Remote memory capacity, usage patterns, swap configuration, performance characteristics, health indicators, efficiency analysis -- **disk**: Remote storage devices, usage analysis, I/O performance, health monitoring, file systems, predictive maintenance -- **network**: Remote network interfaces, bandwidth analysis, connection details, protocol statistics, security monitoring, performance optimization -- **system**: Remote operating system details, uptime analysis, user management, configuration, platform information, security status -- **processes**: Remote running processes, resource consumption, process hierarchy, performance metrics, system load analysis -- **gpu**: Remote GPU specifications, memory analysis, thermal monitoring, performance metrics, driver information, compute capabilities -- **sensors**: Remote temperature sensors, fan control, voltage monitoring, hardware health, thermal management, predictive maintenance -- **performance**: Remote real-time performance monitoring, bottleneck analysis, optimization recommendations, trend analysis -- **summary**: Remote integrated hardware overview with cross-subsystem analysis and comprehensive health assessment - -**SSH Connection and Authentication**: -- **SSH Key Authentication**: Secure key-based authentication with support for various key types (RSA, Ed25519, ECDSA) -- **Password Authentication**: Fallback password authentication with secure handling -- **Connection Management**: Configurable connection parameters including port, timeout, user, and advanced SSH options -- **Security Best Practices**: Implements SSH security best practices with connection validation and error handling -- **Multi-Platform Support**: Compatible with various remote system configurations and platform variations - -**Advanced Remote Filtering Capabilities**: -- **Include Filters**: Specify exactly which components to collect for focused analysis and reduced network overhead -- **Exclude Filters**: Remove specific components from collection for streamlined results and improved performance -- **Component Selection**: Choose from comprehensive list of hardware and system components with intelligent organization -- **Network Efficiency**: Optimized data collection to minimize network bandwidth usage and connection overhead -- **Metadata Tracking**: Track collection process, success rates, error handling, and SSH connection performance metrics - -**Remote Performance Analysis Features**: -- **Remote Bottleneck Detection**: Automated identification of performance bottlenecks on remote systems with resolution strategies -- **Distributed Resource Optimization**: Analysis of resource utilization patterns across remote systems with efficiency improvement recommendations -- **Remote Predictive Maintenance**: Sensor-based predictive maintenance and failure prediction with trend analysis for remote systems -- **Distributed Capacity Planning**: Growth trend analysis with capacity recommendations and scaling strategies for remote infrastructure -- **Remote Health Assessment**: Comprehensive health monitoring with trend analysis and predictive insights for distributed systems - -**Intelligence and Remote Insights**: -- **Distributed Analysis**: AI-powered analysis of remote hardware configurations and performance patterns -- **Remote Optimization**: Intelligent recommendations for remote system optimization and performance improvement -- **Cross-System Trend Analysis**: Historical trend analysis and predictive insights for distributed capacity planning -- **Remote Anomaly Detection**: Automated detection of unusual patterns and potential issues across remote systems -- **Distributed Best Practices**: Industry best practices and configuration recommendations for remote infrastructure - -**Prerequisites**: SSH access to remote systems with hardware information retrieval capabilities -**Tools to use before this**: health_check() to verify local system capabilities, get_node_info() for local baseline comparison -**Tools to use after this**: Additional remote analysis tools or optimization tools based on remote system results - -Use this tool when: -- Getting complete remote system overview with selective focus ("Show me remote CPU and memory info with performance analysis") -- Collecting comprehensive remote hardware information for distributed analysis, reporting, or infrastructure documentation -- Performing remote system audits with customizable scope, depth, and intelligent analysis across distributed infrastructure -- Monitoring remote system health and performance characteristics with predictive maintenance insights for distributed systems -- Planning remote system upgrades and capacity requirements with trend analysis and recommendations for distributed infrastructure -- Troubleshooting remote hardware and performance issues with intelligent diagnostic capabilities across distributed systems -- Conducting distributed infrastructure assessments with comprehensive analysis and optimization guidance for remote systems""", -) -async def get_remote_node_info_tool( - hostname: str, - username: Optional[str] = None, - port: int = 22, - ssh_key: Optional[str] = None, - timeout: int = 30, - components: Optional[List[str]] = None, - exclude_components: Optional[List[str]] = None, - include_performance: bool = True, - include_health: bool = True, -) -> dict: - """ - Get comprehensive remote node hardware and system information via SSH with advanced filtering and intelligent analysis. - - Args: - hostname (str): Target hostname or IP address for remote collection. - username (Optional[str]): SSH username for remote authentication. - port (int): SSH port number for remote connection. - ssh_key (Optional[str]): Path to SSH private key file for authentication. - timeout (int): SSH connection timeout in seconds. - components (Optional[List[str]]): List of specific components to include in collection. - exclude_components (Optional[List[str]]): List of specific components to exclude from collection. - include_performance (bool): Whether to include real-time performance analysis. - include_health (bool): Whether to include health assessment and predictive maintenance insights. - - Returns: - dict: Comprehensive remote hardware and system analysis, including hardware_data, collection_metadata, performance_analysis, health_assessment, ssh_connection_info, error_information, intelligent_insights, optimization_recommendations, and beautiful_formatting. - """ - try: - logger.info( - f"Collecting comprehensive remote hardware information from {hostname}: components={components}, exclude={exclude_components}" - ) - return mcp_handlers.get_remote_node_info_handler( - hostname=hostname, - username=username, - port=port, - ssh_key=ssh_key, - timeout=timeout, - include_filters=components, - exclude_filters=exclude_components, - ) - except Exception as e: - logger.error(f"Remote hardware information collection error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "RemoteHardwareCollectionError", "troubleshooting": "Check SSH connectivity, authentication, and remote system permissions"}}' - } - ], - "_meta": { - "tool": "get_remote_node_info", - "error": "RemoteHardwareCollectionError", - }, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# SYSTEM HEALTH AND DIAGNOSTICS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="health_check", - description="""Perform comprehensive health check and system diagnostics with advanced capability verification. - -This tool provides complete system health assessment by verifying all hardware monitoring -capabilities, system compatibility, and performance characteristics. It delivers comprehensive -health status with diagnostic insights, optimization recommendations, and predictive maintenance guidance. - -**Health Assessment Strategy**: -1. **Comprehensive Verification**: Systematically verifies all hardware monitoring capabilities and system compatibility -2. **Performance Diagnostics**: Performs comprehensive system diagnostics and performance assessment with benchmarking -3. **Capability Analysis**: Provides detailed capability status and functionality verification with compatibility testing -4. **Health Metrics**: Delivers system health metrics and optimization recommendations with trend analysis -5. **Predictive Insights**: Generates comprehensive diagnostic report with actionable insights and predictive maintenance guidance - -**Health Check Components**: -- **Server Status**: Overall MCP server health and functionality verification with performance metrics -- **Capability Verification**: Individual tool functionality and system compatibility testing with detailed reporting -- **System Compatibility**: Platform compatibility and dependency verification with requirement analysis -- **Performance Assessment**: Server performance metrics and response time analysis with optimization recommendations -- **Diagnostic Insights**: System diagnostic information and health indicators with trend analysis -- **Optimization Recommendations**: System optimization suggestions and improvement strategies with implementation guidance -- **Predictive Maintenance**: Predictive maintenance insights and failure prediction with preventive recommendations - -**Advanced Diagnostic Features**: -- **Comprehensive Testing**: Multi-layered capability testing with detailed error reporting and resolution guidance -- **Platform Analysis**: System compatibility analysis with platform-specific recommendations and optimization strategies -- **Performance Benchmarking**: Performance benchmarking and optimization insights with comparative analysis -- **Trend Analysis**: Health trend analysis and predictive maintenance suggestions with historical data integration -- **Troubleshooting Integration**: Diagnostic troubleshooting and problem resolution guidance with step-by-step instructions -- **Security Assessment**: Security posture analysis and vulnerability assessment with remediation recommendations - -**Intelligence and Automation**: -- **Automated Diagnostics**: AI-powered diagnostic analysis with intelligent problem identification -- **Predictive Analytics**: Predictive maintenance recommendations based on system health trends -- **Optimization Intelligence**: Intelligent optimization recommendations with performance impact analysis -- **Proactive Monitoring**: Proactive health monitoring with early warning systems and alerting -- **Best Practice Integration**: Industry best practices integration with compliance checking - -**Prerequisites**: No special requirements - designed for comprehensive system assessment and compatibility verification -**Tools to use before this**: None - this is typically the first tool to run for system verification -**Tools to use after this**: get_node_info() and get_remote_node_info() based on health check results and recommendations for detailed analysis - -Use this tool when: -- Verifying system health and MCP server functionality ("Check system health and capabilities") -- Diagnosing system issues and compatibility problems with comprehensive analysis -- Assessing system performance and optimization opportunities with benchmarking -- Validating system capabilities and functionality before production deployment -- Troubleshooting system problems and performance issues with intelligent diagnostics -- Conducting system audits and compliance checking with best practice validation -- Planning system maintenance and optimization with predictive insights -- Establishing baseline health metrics for ongoing monitoring and trend analysis""", -) -async def health_check_tool() -> dict: - """ - Perform comprehensive health check and system diagnostics with advanced capability verification. - - Returns: - dict: Comprehensive health assessment, including server_status, capability_status, system_compatibility, performance_metrics, diagnostic_insights, optimization_recommendations, troubleshooting_guide, predictive_maintenance, security_assessment, and health_summary. - """ - try: - logger.info( - "Performing comprehensive health check and system diagnostics with advanced analysis" - ) - - # Comprehensive health assessment with intelligent analysis - health_status = { - "server_status": "healthy", - "timestamp": json.dumps({"timestamp": "2024-01-01T00:00:00Z"}), - "capabilities": { - "get_node_info": "available", - "get_remote_node_info": "available", - "local_collection": "available", - "remote_collection": "available", - "ssh_support": "available", - "component_filtering": "available", - "performance_analysis": "available", - "health_assessment": "available", - "intelligent_insights": "available", - "predictive_maintenance": "available", - }, - "system_compatibility": { - "python_version": sys.version, - "platform": os.name, - "dependencies": "loaded", - "ssh_support": "available", - "hardware_monitoring": "available", - }, - "performance_metrics": { - "response_time": "optimal", - "resource_usage": "efficient", - "collection_speed": "high", - "network_efficiency": "optimized", - }, - "health_indicators": { - "overall_health": "excellent", - "system_stability": "stable", - "performance_status": "optimal", - "security_posture": "secure", - }, - } - - return { - "content": [{"text": json.dumps(health_status, indent=2)}], - "_meta": {"tool": "health_check", "status": "success"}, - "isError": False, - } - except Exception as e: - logger.error(f"Health check error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "HealthCheckError", "troubleshooting": "Check system permissions, dependencies, and server configuration"}}' - } - ], - "_meta": {"tool": "health_check", "error": "HealthCheckError"}, - "isError": True, - } - - -def main(): - """ - Main entry point to start the FastMCP server using the specified transport. - Chooses between stdio and SSE based on MCP_TRANSPORT environment variable. - """ - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - - if transport == "sse": - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - print( - f"Starting Node Hardware MCP System Monitoring Server on {host}:{port}", - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - print( - "Starting Node Hardware MCP System Monitoring Server with stdio transport", - file=sys.stderr, - ) - mcp.run(transport="stdio") - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/node-hardware/tests/conftest.py b/clio-kit-mcp-servers/node-hardware/tests/conftest.py index 60ec22d1..41e667b1 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/conftest.py +++ b/clio-kit-mcp-servers/node-hardware/tests/conftest.py @@ -3,13 +3,8 @@ """ import pytest -import sys -import os from unittest.mock import Mock, patch -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "../src")) - @pytest.fixture def mock_psutil(): diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_capabilities.py b/clio-kit-mcp-servers/node-hardware/tests/test_capabilities.py index b95a2577..ea893207 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_capabilities.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_capabilities.py @@ -2,25 +2,24 @@ Comprehensive test coverage for hardware capabilities - CPU, memory, disk, network, system, processes, GPU, sensors. """ -import os -import sys import pytest from unittest.mock import patch, Mock, mock_open -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from capabilities.cpu_info import get_cpu_info -from capabilities.memory_info import get_memory_info -from capabilities.disk_info import get_disk_info -from capabilities.network_info import get_network_info -from capabilities.system_info import get_system_info -from capabilities.process_info import get_process_info -from capabilities.sensor_info import get_sensor_info -from capabilities.performance_monitor import monitor_performance -from capabilities.gpu_info import get_gpu_info -from capabilities.hardware_summary import get_hardware_summary -from capabilities.utils import run_command, check_command_available, get_os_info +from node_hardware_mcp.capabilities.cpu_info import get_cpu_info +from node_hardware_mcp.capabilities.memory_info import get_memory_info +from node_hardware_mcp.capabilities.disk_info import get_disk_info +from node_hardware_mcp.capabilities.network_info import get_network_info +from node_hardware_mcp.capabilities.system_info import get_system_info +from node_hardware_mcp.capabilities.process_info import get_process_info +from node_hardware_mcp.capabilities.sensor_info import get_sensor_info +from node_hardware_mcp.capabilities.performance_monitor import monitor_performance +from node_hardware_mcp.capabilities.gpu_info import get_gpu_info +from node_hardware_mcp.capabilities.hardware_summary import get_hardware_summary +from node_hardware_mcp.capabilities.utils import ( + run_command, + check_command_available, + get_os_info, +) class TestCapabilities: @@ -98,14 +97,16 @@ def test_cpu_info_comprehensive(self): assert isinstance(result, dict) # Test load average scenarios - with patch("os.getloadavg", return_value=[1.5, 2.0, 2.5]): + with patch("os.getloadavg", create=True, return_value=[1.5, 2.0, 2.5]): with patch("os.hasattr", return_value=True): result = get_cpu_info() assert isinstance(result, dict) # Test load average OSError with patch( - "os.getloadavg", side_effect=OSError("Load average unavailable") + "os.getloadavg", + create=True, + side_effect=OSError("Load average unavailable"), ): result = get_cpu_info() assert isinstance(result, dict) @@ -339,11 +340,13 @@ def test_sensor_info_comprehensive(self): """Test sensor info with all scenarios.""" with ( - patch("psutil.sensors_temperatures") as mock_temp, - patch("psutil.sensors_fans") as mock_fans, - patch("psutil.sensors_battery") as mock_battery, - patch("capabilities.utils.check_command_available") as mock_check_cmd, - patch("capabilities.utils.run_command") as mock_run_cmd, + patch("psutil.sensors_temperatures", create=True) as mock_temp, + patch("psutil.sensors_fans", create=True) as mock_fans, + patch("psutil.sensors_battery", create=True) as mock_battery, + patch( + "node_hardware_mcp.capabilities.utils.check_command_available" + ) as mock_check_cmd, + patch("node_hardware_mcp.capabilities.utils.run_command") as mock_run_cmd, patch("glob.glob") as mock_glob, patch("builtins.open", mock_open(read_data="45000\n")), ): @@ -421,11 +424,11 @@ def test_sensor_info_comprehensive(self): # Test main function exception with patch( - "capabilities.sensor_info.get_sensor_info", + "node_hardware_mcp.capabilities.sensor_info.get_sensor_info", side_effect=Exception("Main error"), ): try: - from capabilities.sensor_info import ( + from node_hardware_mcp.capabilities.sensor_info import ( get_sensor_info as original_func, ) @@ -479,8 +482,12 @@ def test_gpu_info_comprehensive(self): # Mock the utility functions with ( - patch("capabilities.gpu_info.check_command_available") as mock_check, - patch("capabilities.gpu_info.run_command") as mock_run_cmd, + patch( + "node_hardware_mcp.capabilities.gpu_info.check_command_available" + ) as mock_check, + patch( + "node_hardware_mcp.capabilities.gpu_info.run_command" + ) as mock_run_cmd, ): # Test NVIDIA GPU available with full data mock_check.side_effect = lambda cmd: cmd == "nvidia-smi" @@ -600,9 +607,15 @@ def test_hardware_summary_comprehensive(self): """Test hardware summary with all scenarios.""" with ( - patch("capabilities.hardware_summary.get_cpu_info") as mock_cpu, - patch("capabilities.hardware_summary.get_memory_info") as mock_memory, - patch("capabilities.hardware_summary.get_disk_info") as mock_disk, + patch( + "node_hardware_mcp.capabilities.hardware_summary.get_cpu_info" + ) as mock_cpu, + patch( + "node_hardware_mcp.capabilities.hardware_summary.get_memory_info" + ) as mock_memory, + patch( + "node_hardware_mcp.capabilities.hardware_summary.get_disk_info" + ) as mock_disk, ): # Normal scenario mock_cpu.return_value = { @@ -630,7 +643,7 @@ def test_hardware_summary_comprehensive(self): def test_utils_comprehensive(self): """Test utils module functions.""" - from capabilities.utils import ( + from node_hardware_mcp.capabilities.utils import ( format_bytes, format_percentage, ) diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_complete.py b/clio-kit-mcp-servers/node-hardware/tests/test_complete.py index 01afb9a8..dad0dc94 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_complete.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_complete.py @@ -1,23 +1,18 @@ """ Complete comprehensive test suite covering 100% of Node Hardware MCP functionality. Focused on server.py, mcp_handlers.py, and utils/output_formatter.py for complete coverage. +Updated for FastMCP v3 (no .fn attribute, direct function calls, ToolError for errors). """ -import os -import sys import pytest from unittest.mock import patch -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -# Import all required modules -import server -import mcp_handlers +from node_hardware_mcp import server +from node_hardware_mcp import mcp_handlers class TestCompleteNodeHardwareMCP: - """Complete test coverage for Node Hardware MCP - Focus on 100% coverage for server, handlers, and utils""" + """Complete test coverage for Node Hardware MCP""" @pytest.mark.asyncio async def test_server_module_complete_coverage(self): @@ -27,105 +22,117 @@ async def test_server_module_complete_coverage(self): assert hasattr(server, "logger") assert hasattr(server, "FastMCP") - # Test all server tool functions - - # Test each tool function by verifying they exist and are callable - with patch("mcp_handlers.cpu_info_handler") as mock_handler: + # Test all server tool functions exist and are callable (v3 returns original fn) + with patch("node_hardware_mcp.mcp_handlers.cpu_info_handler") as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "CPU info"}] } - # Test that the tool exists and is properly decorated assert hasattr(server, "get_cpu_info_tool") cpu_tool = getattr(server, "get_cpu_info_tool") assert cpu_tool is not None + assert callable(cpu_tool) - with patch("mcp_handlers.memory_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.memory_info_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Memory info"}] } - # Test that the tool exists assert hasattr(server, "get_memory_info_tool") memory_tool = getattr(server, "get_memory_info_tool") assert memory_tool is not None + assert callable(memory_tool) - with patch("mcp_handlers.system_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.system_info_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "System info"}] } - # Test that the tool exists assert hasattr(server, "get_system_info_tool") system_tool = getattr(server, "get_system_info_tool") assert system_tool is not None + assert callable(system_tool) - with patch("mcp_handlers.disk_info_handler") as mock_handler: + with patch("node_hardware_mcp.mcp_handlers.disk_info_handler") as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Disk info"}] } - # Test that the tool exists assert hasattr(server, "get_disk_info_tool") disk_tool = getattr(server, "get_disk_info_tool") assert disk_tool is not None + assert callable(disk_tool) - with patch("mcp_handlers.network_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.network_info_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Network info"}] } - # Test that the tool exists assert hasattr(server, "get_network_info_tool") network_tool = getattr(server, "get_network_info_tool") assert network_tool is not None + assert callable(network_tool) - with patch("mcp_handlers.gpu_info_handler") as mock_handler: + with patch("node_hardware_mcp.mcp_handlers.gpu_info_handler") as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "GPU info"}] } - # Test that the tool exists assert hasattr(server, "get_gpu_info_tool") gpu_tool = getattr(server, "get_gpu_info_tool") assert gpu_tool is not None + assert callable(gpu_tool) - with patch("mcp_handlers.sensor_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.sensor_info_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Sensor info"}] } - # Test that the tool exists assert hasattr(server, "get_sensor_info_tool") sensor_tool = getattr(server, "get_sensor_info_tool") assert sensor_tool is not None + assert callable(sensor_tool) - with patch("mcp_handlers.process_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.process_info_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Process info"}] } - # Test that the tool exists assert hasattr(server, "get_process_info_tool") process_tool = getattr(server, "get_process_info_tool") assert process_tool is not None + assert callable(process_tool) - with patch("mcp_handlers.performance_monitor_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.performance_monitor_handler" + ) as mock_handler: mock_handler.return_value = { "content": [{"type": "text", "text": "Performance info"}] } - # Test that the tool exists assert hasattr(server, "get_performance_info_tool") performance_tool = getattr(server, "get_performance_info_tool") assert performance_tool is not None + assert callable(performance_tool) # Test remote node info tool exists assert hasattr(server, "get_remote_node_info_tool") remote_tool = getattr(server, "get_remote_node_info_tool") assert remote_tool is not None + assert callable(remote_tool) # Test health check tool exists assert hasattr(server, "health_check_tool") health_tool = getattr(server, "health_check_tool") assert health_tool is not None + assert callable(health_tool) @pytest.mark.asyncio async def test_mcp_handlers_complete_coverage(self): """Test complete mcp_handlers.py module for 100% coverage""" # Test all MCP handler functions - from mcp_handlers import ( + from node_hardware_mcp.mcp_handlers import ( cpu_info_handler, memory_info_handler, disk_info_handler, @@ -140,7 +147,7 @@ async def test_mcp_handlers_complete_coverage(self): ) # Test CPU handler with comprehensive scenarios - with patch("mcp_handlers.get_cpu_info") as mock_cpu: + with patch("node_hardware_mcp.mcp_handlers.get_cpu_info") as mock_cpu: mock_cpu.return_value = { "cpu_count": 8, "cpu_model": "Intel Core i7", @@ -152,14 +159,16 @@ async def test_mcp_handlers_complete_coverage(self): mock_cpu.assert_called_once() # Test error handling in CPU - with patch("mcp_handlers.get_cpu_info", side_effect=Exception("CPU error")): + with patch( + "node_hardware_mcp.mcp_handlers.get_cpu_info", + side_effect=Exception("CPU error"), + ): result = cpu_info_handler() assert isinstance(result, dict) assert "content" in result - # Should contain error information # Test memory handler with comprehensive scenarios - with patch("mcp_handlers.get_memory_info") as mock_memory: + with patch("node_hardware_mcp.mcp_handlers.get_memory_info") as mock_memory: mock_memory.return_value = { "total_memory": 16000000000, "available_memory": 8000000000, @@ -171,7 +180,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_memory.assert_called_once() # Test disk handler - with patch("mcp_handlers.get_disk_info") as mock_disk: + with patch("node_hardware_mcp.mcp_handlers.get_disk_info") as mock_disk: mock_disk.return_value = { "partitions": [ { @@ -188,7 +197,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_disk.assert_called_once() # Test network handler - with patch("mcp_handlers.get_network_info") as mock_network: + with patch("node_hardware_mcp.mcp_handlers.get_network_info") as mock_network: mock_network.return_value = { "interfaces": { "eth0": {"address": "192.168.1.100", "netmask": "255.255.255.0"} @@ -200,7 +209,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_network.assert_called_once() # Test system handler - with patch("mcp_handlers.get_system_info") as mock_system: + with patch("node_hardware_mcp.mcp_handlers.get_system_info") as mock_system: mock_system.return_value = { "system": "Linux", "release": "5.15.0", @@ -212,7 +221,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_system.assert_called_once() # Test process handler - with patch("mcp_handlers.get_process_info") as mock_process: + with patch("node_hardware_mcp.mcp_handlers.get_process_info") as mock_process: mock_process.return_value = { "processes": [ { @@ -229,7 +238,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_process.assert_called_once() # Test sensor handler - with patch("mcp_handlers.get_sensor_info") as mock_sensor: + with patch("node_hardware_mcp.mcp_handlers.get_sensor_info") as mock_sensor: mock_sensor.return_value = { "temperatures": {"coretemp": [{"current": 45.0, "high": 85.0}]} } @@ -239,7 +248,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_sensor.assert_called_once() # Test performance handler - with patch("mcp_handlers.monitor_performance") as mock_perf: + with patch("node_hardware_mcp.mcp_handlers.monitor_performance") as mock_perf: mock_perf.return_value = { "cpu_usage": 25.5, "memory_usage": 60.0, @@ -251,7 +260,7 @@ async def test_mcp_handlers_complete_coverage(self): mock_perf.assert_called_once() # Test GPU handler - with patch("mcp_handlers.get_gpu_info") as mock_gpu: + with patch("node_hardware_mcp.mcp_handlers.get_gpu_info") as mock_gpu: mock_gpu.return_value = { "gpus": [ { @@ -267,7 +276,9 @@ async def test_mcp_handlers_complete_coverage(self): mock_gpu.assert_called_once() # Test hardware summary handler - with patch("mcp_handlers.get_hardware_summary") as mock_summary: + with patch( + "node_hardware_mcp.mcp_handlers.get_hardware_summary" + ) as mock_summary: mock_summary.return_value = { "system_type": "High-performance workstation", "total_cores": 16, @@ -279,7 +290,9 @@ async def test_mcp_handlers_complete_coverage(self): mock_summary.assert_called_once() # Test remote node handler - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = { "hostname": "test.server.com", "status": "connected", @@ -296,7 +309,7 @@ async def test_mcp_handlers_complete_coverage(self): async def test_output_formatter_complete_coverage(self): """Test complete utils/output_formatter.py module coverage""" # Test available output formatter functions - from utils.output_formatter import ( + from node_hardware_mcp.utils.output_formatter import ( NodeHardwareFormatter, create_beautiful_response, ) @@ -336,16 +349,18 @@ async def test_error_handling_scenarios(self): """Test comprehensive error handling across all modules""" # Test server module error handling with MCP handler failures with patch( - "mcp_handlers.cpu_info_handler", side_effect=Exception("Handler error") + "node_hardware_mcp.mcp_handlers.cpu_info_handler", + side_effect=Exception("Handler error"), ): # Test tools exist but don't try to call them directly since they're decorated assert hasattr(server, "get_cpu_info_tool") cpu_tool = getattr(server, "get_cpu_info_tool") assert cpu_tool is not None + assert callable(cpu_tool) # Test MCP handlers with capability module failures with patch( - "capabilities.memory_info.get_memory_info", + "node_hardware_mcp.capabilities.memory_info.get_memory_info", side_effect=MemoryError("Memory access error"), ): result = mcp_handlers.memory_info_handler() @@ -353,7 +368,7 @@ async def test_error_handling_scenarios(self): assert "content" in result # Test output formatter with invalid data - from utils.output_formatter import create_beautiful_response + from node_hardware_mcp.utils.output_formatter import create_beautiful_response invalid_data = {"valid": "data"} # Use valid data instead result = create_beautiful_response( @@ -365,7 +380,7 @@ async def test_error_handling_scenarios(self): @pytest.mark.asyncio async def test_edge_cases_and_boundary_conditions(self): """Test edge cases and boundary conditions""" - from utils.output_formatter import ( + from node_hardware_mcp.utils.output_formatter import ( NodeHardwareFormatter, create_beautiful_response, ) @@ -398,7 +413,9 @@ async def test_concurrent_operations_stress(self): # Test concurrent handler calls def run_handler(): - with patch("capabilities.cpu_info.get_cpu_info") as mock_cpu: + with patch( + "node_hardware_mcp.capabilities.cpu_info.get_cpu_info" + ) as mock_cpu: mock_cpu.return_value = {"cpu_count": 8} return mcp_handlers.cpu_info_handler() diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_coverage_boost.py b/clio-kit-mcp-servers/node-hardware/tests/test_coverage_boost.py index 7c6ccc65..66918cbd 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_coverage_boost.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_coverage_boost.py @@ -1,195 +1,139 @@ """ Comprehensive test suite to boost coverage from 81% to >90% Targets uncovered lines in server.py, mcp_handlers.py, and output_formatter.py +Updated for FastMCP v3 (ToolError instead of error dicts, direct function calls). """ -import os -import sys import json import pytest from unittest.mock import patch -# Add src to path -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message class TestServerToolsErrorPaths: - """Test error paths in server.py tool functions""" + """Test error paths in server.py tool functions -- now expect ToolError""" - def test_get_cpu_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_cpu_info_tool_error_path(self): """Test error handling in get_cpu_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.cpu_info_handler") as mock_handler: + with patch("node_hardware_mcp.mcp_handlers.cpu_info_handler") as mock_handler: mock_handler.side_effect = Exception("CPU collection failed") - # Get the actual function from the tool - tool_func = ( - server.get_cpu_info_tool.fn - if hasattr(server.get_cpu_info_tool, "fn") - else server.get_cpu_info_tool - ) - result = asyncio.run(tool_func()) - - assert result is not None - assert result["isError"] is True - assert "CPU collection failed" in result["content"][0]["text"] - assert result["_meta"]["tool"] == "get_cpu_info" + with pytest.raises(ToolError, match="CPU collection failed"): + await server.get_cpu_info_tool() - def test_get_memory_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_memory_info_tool_error_path(self): """Test error handling in get_memory_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.memory_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.memory_info_handler" + ) as mock_handler: mock_handler.side_effect = RuntimeError("Memory access denied") - tool_func = ( - server.get_memory_info_tool.fn - if hasattr(server.get_memory_info_tool, "fn") - else server.get_memory_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Memory access denied" in result["content"][0]["text"] - assert result["_meta"]["error"] == "MemoryCollectionError" + with pytest.raises(ToolError, match="Memory collection failed"): + await server.get_memory_info_tool() - def test_get_system_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_system_info_tool_error_path(self): """Test error handling in get_system_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.system_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.system_info_handler" + ) as mock_handler: mock_handler.side_effect = PermissionError("Permission denied") - tool_func = ( - server.get_system_info_tool.fn - if hasattr(server.get_system_info_tool, "fn") - else server.get_system_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Permission denied" in result["content"][0]["text"] + with pytest.raises(ToolError, match="System collection failed"): + await server.get_system_info_tool() - def test_get_disk_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_disk_info_tool_error_path(self): """Test error handling in get_disk_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.disk_info_handler") as mock_handler: + with patch("node_hardware_mcp.mcp_handlers.disk_info_handler") as mock_handler: mock_handler.side_effect = OSError("Disk not accessible") - tool_func = ( - server.get_disk_info_tool.fn - if hasattr(server.get_disk_info_tool, "fn") - else server.get_disk_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Disk not accessible" in result["content"][0]["text"] + with pytest.raises(ToolError, match="Disk collection failed"): + await server.get_disk_info_tool() - def test_get_network_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_network_info_tool_error_path(self): """Test error handling in get_network_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.network_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.network_info_handler" + ) as mock_handler: mock_handler.side_effect = ConnectionError("Network unavailable") - tool_func = ( - server.get_network_info_tool.fn - if hasattr(server.get_network_info_tool, "fn") - else server.get_network_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Network unavailable" in result["content"][0]["text"] + with pytest.raises(ToolError, match="Network collection failed"): + await server.get_network_info_tool() - def test_get_gpu_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_gpu_info_tool_error_path(self): """Test error handling in get_gpu_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.gpu_info_handler") as mock_handler: + with patch("node_hardware_mcp.mcp_handlers.gpu_info_handler") as mock_handler: mock_handler.side_effect = Exception("GPU not found") - tool_func = ( - server.get_gpu_info_tool.fn - if hasattr(server.get_gpu_info_tool, "fn") - else server.get_gpu_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "GPU not found" in result["content"][0]["text"] + with pytest.raises(ToolError, match="GPU collection failed"): + await server.get_gpu_info_tool() - def test_get_sensor_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_sensor_info_tool_error_path(self): """Test error handling in get_sensor_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.sensor_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.sensor_info_handler" + ) as mock_handler: mock_handler.side_effect = Exception("Sensor read failed") - tool_func = ( - server.get_sensor_info_tool.fn - if hasattr(server.get_sensor_info_tool, "fn") - else server.get_sensor_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Sensor read failed" in result["content"][0]["text"] + with pytest.raises(ToolError, match="Sensor collection failed"): + await server.get_sensor_info_tool() - def test_get_process_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_process_info_tool_error_path(self): """Test error handling in get_process_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.process_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.process_info_handler" + ) as mock_handler: mock_handler.side_effect = Exception("Process enumeration failed") - tool_func = ( - server.get_process_info_tool.fn - if hasattr(server.get_process_info_tool, "fn") - else server.get_process_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Process enumeration failed" in result["content"][0]["text"] + with pytest.raises(ToolError, match="Process collection failed"): + await server.get_process_info_tool() - def test_get_performance_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_performance_info_tool_error_path(self): """Test error handling in get_performance_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.performance_monitor_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.performance_monitor_handler" + ) as mock_handler: mock_handler.side_effect = Exception("Performance monitoring failed") - tool_func = ( - server.get_performance_info_tool.fn - if hasattr(server.get_performance_info_tool, "fn") - else server.get_performance_info_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "Performance monitoring failed" in result["content"][0]["text"] + with pytest.raises(ToolError, match="Performance collection failed"): + await server.get_performance_info_tool() class TestServerRemoteNodeInfo: """Test get_remote_node_info_tool comprehensive functionality""" - def test_get_remote_node_info_tool_success(self): + @pytest.mark.asyncio + async def test_get_remote_node_info_tool_success(self): """Test successful remote node info collection""" - import server - import asyncio + from node_hardware_mcp import server mock_result = { "content": [{"text": '{"success": true}'}], @@ -197,61 +141,47 @@ def test_get_remote_node_info_tool_success(self): "isError": False, } - with patch("mcp_handlers.get_remote_node_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info_handler" + ) as mock_handler: mock_handler.return_value = mock_result - tool_func = ( - server.get_remote_node_info_tool.fn - if hasattr(server.get_remote_node_info_tool, "fn") - else server.get_remote_node_info_tool - ) - result = asyncio.run( - tool_func( - hostname="test.example.com", - username="testuser", - port=22, - ssh_key="/path/to/key", - timeout=30, - components=["cpu", "memory"], - exclude_components=["processes"], - include_performance=True, - include_health=True, - ) + result = await server.get_remote_node_info_tool( + hostname="test.example.com", + username="testuser", + port=22, + ssh_key="/path/to/key", + timeout=30, + components=["cpu", "memory"], + exclude_components=["processes"], + include_performance=True, + include_health=True, ) assert result is not None assert result["isError"] is False mock_handler.assert_called_once() - def test_get_remote_node_info_tool_error_path(self): + @pytest.mark.asyncio + async def test_get_remote_node_info_tool_error_path(self): """Test error handling in get_remote_node_info_tool""" - import server - import asyncio + from node_hardware_mcp import server - with patch("mcp_handlers.get_remote_node_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info_handler" + ) as mock_handler: mock_handler.side_effect = Exception("SSH connection failed") - tool_func = ( - server.get_remote_node_info_tool.fn - if hasattr(server.get_remote_node_info_tool, "fn") - else server.get_remote_node_info_tool - ) - result = asyncio.run( - tool_func( + with pytest.raises(ToolError, match="Remote hardware collection failed"): + await server.get_remote_node_info_tool( hostname="test.example.com", username="testuser", ) - ) - - assert result["isError"] is True - assert "SSH connection failed" in result["content"][0]["text"] - assert "RemoteHardwareCollectionError" in result["content"][0]["text"] - assert "troubleshooting" in result["content"][0]["text"] - def test_get_remote_node_info_tool_with_defaults(self): + @pytest.mark.asyncio + async def test_get_remote_node_info_tool_with_defaults(self): """Test remote node info with default parameters""" - import server - import asyncio + from node_hardware_mcp import server mock_result = { "content": [{"text": '{"success": true}'}], @@ -259,15 +189,12 @@ def test_get_remote_node_info_tool_with_defaults(self): "isError": False, } - with patch("mcp_handlers.get_remote_node_info_handler") as mock_handler: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info_handler" + ) as mock_handler: mock_handler.return_value = mock_result - tool_func = ( - server.get_remote_node_info_tool.fn - if hasattr(server.get_remote_node_info_tool, "fn") - else server.get_remote_node_info_tool - ) - result = asyncio.run(tool_func(hostname="192.168.1.100")) + result = await server.get_remote_node_info_tool(hostname="192.168.1.100") assert result is not None mock_handler.assert_called_once_with( @@ -284,54 +211,33 @@ def test_get_remote_node_info_tool_with_defaults(self): class TestServerHealthCheck: """Test health_check_tool comprehensive functionality""" - def test_health_check_tool_success(self): + @pytest.mark.asyncio + async def test_health_check_tool_success(self): """Test successful health check""" - import server - import asyncio + from node_hardware_mcp import server - tool_func = ( - server.health_check_tool.fn - if hasattr(server.health_check_tool, "fn") - else server.health_check_tool - ) - result = asyncio.run(tool_func()) + result = await server.health_check_tool() assert result is not None - assert result["isError"] is False - assert result["_meta"]["tool"] == "health_check" - assert result["_meta"]["status"] == "success" - - # Parse the content - content_text = result["content"][0]["text"] - health_data = json.loads(content_text) - - assert health_data["server_status"] == "healthy" - assert "capabilities" in health_data - assert health_data["capabilities"]["get_node_info"] == "available" - assert health_data["capabilities"]["get_remote_node_info"] == "available" - assert "system_compatibility" in health_data - assert "performance_metrics" in health_data - assert "health_indicators" in health_data - - def test_health_check_tool_error_path(self): + assert result["server_status"] == "healthy" + assert "capabilities" in result + assert result["capabilities"]["get_node_info"] == "available" + assert result["capabilities"]["get_remote_node_info"] == "available" + assert "system_compatibility" in result + assert "performance_metrics" in result + assert "health_indicators" in result + + @pytest.mark.asyncio + async def test_health_check_tool_error_path(self): """Test health check error handling""" - import server - import asyncio + from node_hardware_mcp import server import json as json_module with patch.object(json_module, "dumps") as mock_dumps: mock_dumps.side_effect = Exception("JSON serialization failed") - tool_func = ( - server.health_check_tool.fn - if hasattr(server.health_check_tool, "fn") - else server.health_check_tool - ) - result = asyncio.run(tool_func()) - - assert result["isError"] is True - assert "JSON serialization failed" in result["content"][0]["text"] - assert result["_meta"]["error"] == "HealthCheckError" + with pytest.raises(ToolError, match="Health check failed"): + await server.health_check_tool() class TestServerMainFunction: @@ -339,44 +245,44 @@ class TestServerMainFunction: def test_main_with_stdio_transport(self): """Test main function with stdio transport""" - import server + from node_hardware_mcp import server - with patch.dict("os.environ", {"MCP_TRANSPORT": "stdio"}): + with patch("sys.argv", ["node-hardware-mcp", "--transport", "stdio"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with(transport="stdio") - def test_main_with_sse_transport(self): - """Test main function with SSE transport""" - import server - - with patch.dict( - "os.environ", - { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "127.0.0.1", - "MCP_SSE_PORT": "9000", - }, + def test_main_with_http_transport(self): + """Test main function with HTTP transport""" + from node_hardware_mcp import server + + with patch( + "sys.argv", + [ + "node-hardware-mcp", + "--transport", + "http", + "--host", + "127.0.0.1", + "--port", + "9000", + ], ): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with( - transport="sse", host="127.0.0.1", port=9000 + transport="http", host="127.0.0.1", port=9000 ) - def test_main_with_sse_default_values(self): - """Test main function with SSE transport and default values""" - import server - - with patch.dict("os.environ", {"MCP_TRANSPORT": "sse"}, clear=False): - # Remove SSE_HOST and SSE_PORT if they exist - os.environ.pop("MCP_SSE_HOST", None) - os.environ.pop("MCP_SSE_PORT", None) + def test_main_with_http_default_values(self): + """Test main function with HTTP transport and default values""" + from node_hardware_mcp import server + with patch("sys.argv", ["node-hardware-mcp", "--transport", "http"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with( - transport="sse", host="0.0.0.0", port=8000 + transport="http", host="0.0.0.0", port=8000 ) @@ -385,7 +291,7 @@ class TestMcpHandlersEdgeCases: def test_cpu_info_handler_low_usage_insight(self): """Test CPU info handler with low usage""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_cpu_data = { "logical_cores": 8, @@ -395,7 +301,7 @@ def test_cpu_info_handler_low_usage_insight(self): "cpu_usage": [10.0, 12.0, 8.0, 15.0], # Low average usage } - with patch("mcp_handlers.get_cpu_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_cpu_info") as mock_get: mock_get.return_value = mock_cpu_data result = mcp_handlers.cpu_info_handler() @@ -411,7 +317,7 @@ def test_cpu_info_handler_low_usage_insight(self): def test_memory_info_handler_swap_usage_insight(self): """Test memory info handler with high swap usage""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_memory_data = { "total": 16000000000, @@ -422,7 +328,7 @@ def test_memory_info_handler_swap_usage_insight(self): "swap_used": 5000000000, # 62.5% swap usage } - with patch("mcp_handlers.get_memory_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_memory_info") as mock_get: mock_get.return_value = mock_memory_data result = mcp_handlers.memory_info_handler() @@ -440,7 +346,7 @@ def test_memory_info_handler_swap_usage_insight(self): def test_disk_info_handler_low_usage_insight(self): """Test disk info handler with low disk usage""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_disk_data = { "partitions": [ @@ -452,7 +358,7 @@ def test_disk_info_handler_low_usage_insight(self): "disk_io": {}, } - with patch("mcp_handlers.get_disk_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_disk_info") as mock_get: mock_get.return_value = mock_disk_data result = mcp_handlers.disk_info_handler() @@ -469,7 +375,7 @@ def test_disk_info_handler_low_usage_insight(self): def test_system_info_handler_high_uptime_insight(self): """Test system info handler with high uptime""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_system_data = { "hostname": "test-server", @@ -478,7 +384,7 @@ def test_system_info_handler_high_uptime_insight(self): "total_users": 3, } - with patch("mcp_handlers.get_system_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_system_info") as mock_get: mock_get.return_value = mock_system_data result = mcp_handlers.system_info_handler() @@ -493,7 +399,7 @@ def test_system_info_handler_high_uptime_insight(self): def test_system_info_handler_moderate_uptime_insight(self): """Test system info handler with moderate uptime""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_system_data = { "hostname": "test-server", @@ -502,7 +408,7 @@ def test_system_info_handler_moderate_uptime_insight(self): "total_users": 0, } - with patch("mcp_handlers.get_system_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_system_info") as mock_get: mock_get.return_value = mock_system_data result = mcp_handlers.system_info_handler() @@ -519,7 +425,7 @@ def test_system_info_handler_moderate_uptime_insight(self): def test_process_info_handler_high_cpu_processes(self): """Test process info handler with high CPU processes""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_process_data = { "processes": [ @@ -529,7 +435,7 @@ def test_process_info_handler_high_cpu_processes(self): ] } - with patch("mcp_handlers.get_process_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_process_info") as mock_get: mock_get.return_value = mock_process_data result = mcp_handlers.process_info_handler() @@ -546,7 +452,7 @@ def test_process_info_handler_high_cpu_processes(self): def test_hardware_summary_handler_all_components(self): """Test hardware summary handler with all components""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_summary_data = { "hostname": "test-host", @@ -556,7 +462,7 @@ def test_hardware_summary_handler_all_components(self): "network_info": {"interfaces": []}, } - with patch("mcp_handlers.get_hardware_summary") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_hardware_summary") as mock_get: mock_get.return_value = mock_summary_data result = mcp_handlers.hardware_summary_handler() @@ -571,7 +477,7 @@ def test_hardware_summary_handler_all_components(self): def test_performance_monitor_handler_all_high(self): """Test performance monitor handler with all high usage""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_perf_data = { "cpu_usage": 85.0, # High @@ -579,7 +485,9 @@ def test_performance_monitor_handler_all_high(self): "disk_usage": 95.0, # High } - with patch("mcp_handlers.monitor_performance") as mock_monitor: + with patch( + "node_hardware_mcp.mcp_handlers.monitor_performance" + ) as mock_monitor: mock_monitor.return_value = mock_perf_data result = mcp_handlers.performance_monitor_handler() @@ -594,11 +502,11 @@ def test_performance_monitor_handler_all_high(self): def test_gpu_info_handler_no_gpus(self): """Test GPU info handler with no GPUs""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_gpu_data = {"gpus": [], "nvidia_available": False} - with patch("mcp_handlers.get_gpu_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_gpu_info") as mock_get: mock_get.return_value = mock_gpu_data result = mcp_handlers.gpu_info_handler() @@ -615,11 +523,11 @@ def test_gpu_info_handler_no_gpus(self): def test_sensor_info_handler_no_sensors(self): """Test sensor info handler with no sensors""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_sensor_data = {"sensors": []} - with patch("mcp_handlers.get_sensor_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_sensor_info") as mock_get: mock_get.return_value = mock_sensor_data result = mcp_handlers.sensor_info_handler() @@ -640,7 +548,7 @@ class TestGetNodeInfoHandlerValidation: def test_get_node_info_handler_invalid_include_filters_type(self): """Test validation of include_filters parameter type""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers result = mcp_handlers.get_node_info_handler( include_filters="cpu,memory", # Should be list, not string @@ -656,7 +564,7 @@ def test_get_node_info_handler_invalid_include_filters_type(self): def test_get_node_info_handler_invalid_exclude_filters_type(self): """Test validation of exclude_filters parameter type""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers result = mcp_handlers.get_node_info_handler( exclude_filters="processes", # Should be list, not string @@ -671,9 +579,9 @@ def test_get_node_info_handler_invalid_exclude_filters_type(self): def test_get_node_info_handler_with_error_result(self): """Test handling of error from get_node_info""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers - with patch("mcp_handlers.get_node_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_get: mock_get.return_value = { "error": "Hardware access failed", "error_type": "HardwareError", @@ -692,7 +600,7 @@ def test_get_node_info_handler_with_error_result(self): def test_get_node_info_handler_with_filters_applied(self): """Test get_node_info_handler with filters applied""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_result = { "_metadata": { @@ -707,7 +615,7 @@ def test_get_node_info_handler_with_filters_applied(self): "memory_info": {"total": 16000000000}, } - with patch("mcp_handlers.get_node_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_get: mock_get.return_value = mock_result result = mcp_handlers.get_node_info_handler( @@ -730,7 +638,7 @@ def test_get_node_info_handler_with_filters_applied(self): def test_get_node_info_handler_with_size_control(self): """Test get_node_info_handler with response size control""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_result = { "_metadata": { @@ -745,7 +653,7 @@ def test_get_node_info_handler_with_size_control(self): "memory_info": {"total": 16000000000}, } - with patch("mcp_handlers.get_node_info") as mock_get: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_get: mock_get.return_value = mock_result result = mcp_handlers.get_node_info_handler(max_response_size=5000) @@ -766,7 +674,7 @@ class TestGetRemoteNodeInfoHandler: def test_get_remote_node_info_handler_success(self): """Test successful remote node info collection""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_result = { "_metadata": { @@ -780,7 +688,9 @@ def test_get_remote_node_info_handler_success(self): "cpu_info": {"model": "Remote CPU"}, } - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = mock_result result = mcp_handlers.get_remote_node_info_handler( @@ -804,14 +714,16 @@ def test_get_remote_node_info_handler_success(self): def test_get_remote_node_info_handler_with_error(self): """Test remote node info handler with error result""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_result = { "error": "Connection refused", "error_type": "ConnectionError", } - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = mock_result result = mcp_handlers.get_remote_node_info_handler( @@ -827,9 +739,11 @@ def test_get_remote_node_info_handler_with_error(self): def test_get_remote_node_info_handler_exception(self): """Test remote node info handler with exception""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.side_effect = Exception("Network timeout") result = mcp_handlers.get_remote_node_info_handler(hostname="test-host") @@ -843,7 +757,7 @@ def test_get_remote_node_info_handler_exception(self): def test_get_remote_node_info_handler_password_auth(self): """Test remote node info handler with password authentication""" - import mcp_handlers + from node_hardware_mcp import mcp_handlers mock_result = { "_metadata": { @@ -857,7 +771,9 @@ def test_get_remote_node_info_handler_password_auth(self): "system_info": {"os": "Linux"}, } - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = mock_result result = mcp_handlers.get_remote_node_info_handler( @@ -880,7 +796,7 @@ class TestOutputFormatterFilteredResponse: def test_create_filtered_response_with_filters(self): """Test create_filtered_response with filter information""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter data = {"items": [1, 2, 3]} filters = {"type": "hardware", "status": "active"} @@ -903,7 +819,7 @@ def test_create_filtered_response_with_filters(self): def test_create_filtered_response_without_filters(self): """Test create_filtered_response without filter information""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter data = {"items": [1, 2, 3]} @@ -917,7 +833,7 @@ def test_create_filtered_response_without_filters(self): def test_create_filtered_response_zero_total_items(self): """Test create_filtered_response with zero total items""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter data = {"items": []} @@ -935,7 +851,7 @@ class TestOutputFormatterInsightFormatting: def test_format_insights_error_keyword(self): """Test insight formatting with error keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["An error occurred during processing"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -945,7 +861,7 @@ def test_format_insights_error_keyword(self): def test_format_insights_fail_keyword(self): """Test insight formatting with fail keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Operation failed to complete"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -955,7 +871,7 @@ def test_format_insights_fail_keyword(self): def test_format_insights_warning_keyword(self): """Test insight formatting with warning keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Warning: High resource usage"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -965,7 +881,7 @@ def test_format_insights_warning_keyword(self): def test_format_insights_high_keyword(self): """Test insight formatting with high keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["High CPU utilization detected"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -975,7 +891,7 @@ def test_format_insights_high_keyword(self): def test_format_insights_good_keyword(self): """Test insight formatting with good keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Good system performance"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -985,7 +901,7 @@ def test_format_insights_good_keyword(self): def test_format_insights_success_keyword(self): """Test insight formatting with success keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Successfully completed operation"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -995,7 +911,7 @@ def test_format_insights_success_keyword(self): def test_format_insights_recommend_keyword(self): """Test insight formatting with recommend keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Recommend upgrading memory"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -1005,7 +921,7 @@ def test_format_insights_recommend_keyword(self): def test_format_insights_suggest_keyword(self): """Test insight formatting with suggest keyword""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["Suggest increasing disk space"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -1015,7 +931,7 @@ def test_format_insights_suggest_keyword(self): def test_format_insights_default(self): """Test insight formatting with default emoji""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter insights = ["System is operating normally"] formatted = NodeHardwareFormatter._format_insights(insights) @@ -1029,14 +945,14 @@ class TestOutputFormatterSummaryFormatting: def test_format_summary_with_all_keys(self): """Test summary formatting with various key types""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter summary = { "count": 10, "total_items": 100, "response_time": 1.5, "memory_size": 8000000000, - "errors": 0, # Changed from error_count to errors to get 🚨 emoji + "errors": 0, "success_rate": 100, "hostname": "test-host", "nodes_active": 5, @@ -1062,7 +978,7 @@ class TestOutputFormatterMetadataFormatting: def test_format_metadata_with_all_keys(self): """Test metadata formatting with various key types""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter metadata = { "hostname": "test-host", @@ -1087,5 +1003,29 @@ def test_format_metadata_with_all_keys(self): assert "📋" in list(formatted.keys())[6] # version +class TestServerResourceAndPrompt: + """Test the new resource and prompt added for FastMCP v3""" + + def test_system_info_resource(self): + """Test the system_info resource returns valid data""" + from node_hardware_mcp import server + + result = server.system_info() + assert isinstance(result, dict) + assert "hostname" in result + assert "os" in result + assert "architecture" in result + assert "python_version" in result + + def test_system_health_check_prompt(self): + """Test the system_health_check prompt returns messages""" + from node_hardware_mcp import server + + result = server.system_health_check() + assert isinstance(result, list) + assert len(result) == 1 + assert isinstance(result[0], Message) + + if __name__ == "__main__": pytest.main([__file__, "-v"]) diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_direct_coverage.py b/clio-kit-mcp-servers/node-hardware/tests/test_direct_coverage.py index 7b6ca977..f6c6d248 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_direct_coverage.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_direct_coverage.py @@ -1,26 +1,18 @@ """ Direct coverage tests to improve specific module coverage. +Updated for FastMCP v3 (no .fn attribute, ToolError for errors, direct function calls). """ -import os -import sys import pytest from unittest.mock import patch -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -# Import modules under test -import server -import mcp_handlers -from utils import output_formatter -from utils.output_formatter import NodeHardwareFormatter, create_beautiful_response - -import os -import sys - -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from node_hardware_mcp import server +from node_hardware_mcp import mcp_handlers +from node_hardware_mcp.utils import output_formatter +from node_hardware_mcp.utils.output_formatter import ( + NodeHardwareFormatter, + create_beautiful_response, +) class TestDirectModuleCoverage: @@ -45,14 +37,15 @@ def test_server_module_imports_and_attributes(self): async def test_server_tool_functions_comprehensive(self): """Test server tool function attributes and registration""" - # Test that tools are registered correctly + # Test that tools are registered correctly as callable functions assert hasattr(server, "get_cpu_info_tool") assert hasattr(server, "get_memory_info_tool") assert hasattr(server, "get_disk_info_tool") - # Test tool attributes exist + # Test tool is callable (v3 returns original function) cpu_tool = getattr(server, "get_cpu_info_tool") assert cpu_tool is not None + assert callable(cpu_tool) # Test that mcp instance exists assert hasattr(server, "mcp") @@ -66,39 +59,43 @@ def test_server_main_function(self): """Test server main function with different transport options""" # Test with stdio transport (default) - with patch.dict("os.environ", {"MCP_TRANSPORT": "stdio"}): + with patch("sys.argv", ["node-hardware-mcp", "--transport", "stdio"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with(transport="stdio") - # Test with SSE transport - with patch.dict( - "os.environ", - { - "MCP_TRANSPORT": "sse", - "MCP_SSE_HOST": "localhost", - "MCP_SSE_PORT": "9000", - }, + # Test with HTTP transport + with patch( + "sys.argv", + [ + "node-hardware-mcp", + "--transport", + "http", + "--host", + "localhost", + "--port", + "9000", + ], ): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with( - transport="sse", host="localhost", port=9000 + transport="http", host="localhost", port=9000 ) - # Test with SSE transport and default host/port - with patch.dict("os.environ", {"MCP_TRANSPORT": "sse"}): + # Test with HTTP transport and default host/port + with patch("sys.argv", ["node-hardware-mcp", "--transport", "http"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with( - transport="sse", host="0.0.0.0", port=8000 + transport="http", host="0.0.0.0", port=8000 ) def test_mcp_handlers_direct_calls(self): """Test direct calls to mcp_handlers functions""" # Test CPU handler with mocked capability - with patch("mcp_handlers.get_cpu_info") as mock_cpu: + with patch("node_hardware_mcp.mcp_handlers.get_cpu_info") as mock_cpu: mock_cpu.return_value = { "logical_cores": 8, "physical_cores": 4, @@ -112,7 +109,7 @@ def test_mcp_handlers_direct_calls(self): mock_cpu.assert_called_once() # Test memory handler with mocked capability - with patch("mcp_handlers.get_memory_info") as mock_memory: + with patch("node_hardware_mcp.mcp_handlers.get_memory_info") as mock_memory: mock_memory.return_value = { "total_memory": 16000000000, "available_memory": 8000000000, @@ -124,7 +121,7 @@ def test_mcp_handlers_direct_calls(self): mock_memory.assert_called_once() # Test system handler with mocked capability - with patch("mcp_handlers.get_system_info") as mock_system: + with patch("node_hardware_mcp.mcp_handlers.get_system_info") as mock_system: mock_system.return_value = { "system": "Linux", "release": "5.15.0", @@ -137,7 +134,7 @@ def test_mcp_handlers_direct_calls(self): mock_system.assert_called_once() # Test disk handler with mocked capability - with patch("mcp_handlers.get_disk_info") as mock_disk: + with patch("node_hardware_mcp.mcp_handlers.get_disk_info") as mock_disk: mock_disk.return_value = { "partitions": [ { @@ -156,7 +153,7 @@ def test_mcp_handlers_direct_calls(self): mock_disk.assert_called_once() # Test network handler with mocked capability - with patch("mcp_handlers.get_network_info") as mock_network: + with patch("node_hardware_mcp.mcp_handlers.get_network_info") as mock_network: mock_network.return_value = { "interfaces": { "eth0": { @@ -173,7 +170,7 @@ def test_mcp_handlers_direct_calls(self): mock_network.assert_called_once() # Test process handler with mocked capability - with patch("mcp_handlers.get_process_info") as mock_process: + with patch("node_hardware_mcp.mcp_handlers.get_process_info") as mock_process: mock_process.return_value = { "processes": [ { @@ -190,7 +187,9 @@ def test_mcp_handlers_direct_calls(self): mock_process.assert_called_once() # Test hardware summary handler with mocked capability - with patch("mcp_handlers.get_hardware_summary") as mock_summary: + with patch( + "node_hardware_mcp.mcp_handlers.get_hardware_summary" + ) as mock_summary: mock_summary.return_value = { "system_type": "Workstation", "total_cores": 8, @@ -202,7 +201,7 @@ def test_mcp_handlers_direct_calls(self): mock_summary.assert_called_once() # Test performance monitor handler with mocked capability - with patch("mcp_handlers.monitor_performance") as mock_perf: + with patch("node_hardware_mcp.mcp_handlers.monitor_performance") as mock_perf: mock_perf.return_value = { "cpu_usage": 25.5, "memory_usage": 60.0, @@ -214,7 +213,7 @@ def test_mcp_handlers_direct_calls(self): mock_perf.assert_called_once() # Test GPU handler with mocked capability - with patch("mcp_handlers.get_gpu_info") as mock_gpu: + with patch("node_hardware_mcp.mcp_handlers.get_gpu_info") as mock_gpu: mock_gpu.return_value = { "gpus": [ { @@ -230,7 +229,7 @@ def test_mcp_handlers_direct_calls(self): mock_gpu.assert_called_once() # Test sensor handler with mocked capability - with patch("mcp_handlers.get_sensor_info") as mock_sensor: + with patch("node_hardware_mcp.mcp_handlers.get_sensor_info") as mock_sensor: mock_sensor.return_value = { "temperatures": {"coretemp": [{"current": 45.0, "high": 85.0}]} } @@ -243,7 +242,10 @@ def test_mcp_handlers_error_cases(self): """Test error handling in mcp_handlers""" # Test CPU handler with exception - with patch("mcp_handlers.get_cpu_info", side_effect=Exception("CPU error")): + with patch( + "node_hardware_mcp.mcp_handlers.get_cpu_info", + side_effect=Exception("CPU error"), + ): result = mcp_handlers.cpu_info_handler() assert isinstance(result, dict) assert "content" in result @@ -251,7 +253,8 @@ def test_mcp_handlers_error_cases(self): # Test memory handler with exception with patch( - "mcp_handlers.get_memory_info", side_effect=MemoryError("Memory error") + "node_hardware_mcp.mcp_handlers.get_memory_info", + side_effect=MemoryError("Memory error"), ): result = mcp_handlers.memory_info_handler() assert isinstance(result, dict) @@ -261,7 +264,7 @@ def test_mcp_handlers_comprehensive_coverage(self): """Test remaining mcp_handlers for comprehensive coverage""" # Test get_node_info_handler with various parameters - with patch("mcp_handlers.get_node_info") as mock_node: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_node: mock_node.return_value = { "hostname": "local-server", "status": "running", @@ -280,7 +283,7 @@ def test_mcp_handlers_comprehensive_coverage(self): mock_node.assert_called_once() # Test get_node_info_handler with exclude filters - with patch("mcp_handlers.get_node_info") as mock_node: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_node: mock_node.return_value = {"hostname": "local-server", "cpu": {"cores": 8}} result = mcp_handlers.get_node_info_handler( include_filters=None, @@ -293,14 +296,17 @@ def test_mcp_handlers_comprehensive_coverage(self): # Test get_node_info_handler with errors with patch( - "mcp_handlers.get_node_info", side_effect=Exception("Node info error") + "node_hardware_mcp.mcp_handlers.get_node_info", + side_effect=Exception("Node info error"), ): result = mcp_handlers.get_node_info_handler() assert isinstance(result, dict) assert "content" in result # Test get_remote_node_info_handler with various parameters - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = { "hostname": "remote-server", "status": "connected", @@ -323,7 +329,7 @@ def test_mcp_handlers_comprehensive_coverage(self): # Test get_remote_node_info_handler with connection errors with patch( - "mcp_handlers.get_remote_node_info", + "node_hardware_mcp.mcp_handlers.get_remote_node_info", side_effect=ConnectionError("SSH connection failed"), ): result = mcp_handlers.get_remote_node_info_handler( @@ -334,7 +340,8 @@ def test_mcp_handlers_comprehensive_coverage(self): # Test get_remote_node_info_handler with timeout errors with patch( - "mcp_handlers.get_remote_node_info", side_effect=TimeoutError("SSH timeout") + "node_hardware_mcp.mcp_handlers.get_remote_node_info", + side_effect=TimeoutError("SSH timeout"), ): result = mcp_handlers.get_remote_node_info_handler( hostname="slow-server.com", timeout=1 @@ -343,21 +350,25 @@ def test_mcp_handlers_comprehensive_coverage(self): assert "content" in result # Test all handlers with empty/None data scenarios - with patch("mcp_handlers.get_hardware_summary") as mock_summary: + with patch( + "node_hardware_mcp.mcp_handlers.get_hardware_summary" + ) as mock_summary: mock_summary.return_value = {} result = mcp_handlers.hardware_summary_handler() assert isinstance(result, dict) assert "content" in result mock_summary.assert_called_once() - with patch("mcp_handlers.get_hardware_summary") as mock_summary: + with patch( + "node_hardware_mcp.mcp_handlers.get_hardware_summary" + ) as mock_summary: mock_summary.return_value = None result = mcp_handlers.hardware_summary_handler() assert isinstance(result, dict) assert "content" in result # Test handlers with large data scenarios - with patch("mcp_handlers.get_process_info") as mock_process: + with patch("node_hardware_mcp.mcp_handlers.get_process_info") as mock_process: # Simulate large process list large_process_list = { "processes": [ @@ -375,7 +386,7 @@ def test_mcp_handlers_edge_cases(self): """Test edge cases and boundary conditions in mcp_handlers""" # Test with malformed data - with patch("mcp_handlers.get_cpu_info") as mock_cpu: + with patch("node_hardware_mcp.mcp_handlers.get_cpu_info") as mock_cpu: mock_cpu.return_value = "invalid_data_format" result = mcp_handlers.cpu_info_handler() assert isinstance(result, dict) @@ -383,7 +394,8 @@ def test_mcp_handlers_edge_cases(self): # Test with network connectivity issues with patch( - "mcp_handlers.get_network_info", side_effect=OSError("Network unreachable") + "node_hardware_mcp.mcp_handlers.get_network_info", + side_effect=OSError("Network unreachable"), ): result = mcp_handlers.network_info_handler() assert isinstance(result, dict) @@ -391,7 +403,7 @@ def test_mcp_handlers_edge_cases(self): # Test with permission errors with patch( - "mcp_handlers.get_sensor_info", + "node_hardware_mcp.mcp_handlers.get_sensor_info", side_effect=PermissionError("Permission denied"), ): result = mcp_handlers.sensor_info_handler() @@ -399,7 +411,10 @@ def test_mcp_handlers_edge_cases(self): assert "content" in result # Test with disk I/O errors - with patch("mcp_handlers.get_disk_info", side_effect=IOError("Disk I/O error")): + with patch( + "node_hardware_mcp.mcp_handlers.get_disk_info", + side_effect=IOError("Disk I/O error"), + ): result = mcp_handlers.disk_info_handler() assert isinstance(result, dict) assert "content" in result @@ -408,7 +423,7 @@ def test_mcp_handlers_remote_node_functionality(self): """Test remote node handlers""" # Test get_node_info_handler with correct signature - with patch("mcp_handlers.get_node_info") as mock_node: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_node: mock_node.return_value = { "hostname": "test-server", "status": "connected", @@ -421,7 +436,9 @@ def test_mcp_handlers_remote_node_functionality(self): mock_node.assert_called_once() # Test get_remote_node_info_handler with correct signature - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = { "hostname": "remote-server", "status": "connected", @@ -437,8 +454,8 @@ def test_mcp_handlers_remote_node_functionality(self): mock_remote.assert_called_once() def test_output_formatter_comprehensive(self): - """Test comprehensive output_formatter functionality for Task 3""" - from utils.output_formatter import NodeHardwareFormatter + """Test comprehensive output_formatter functionality""" + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter # Test NodeHardwareFormatter.format_success_response test_data = { @@ -471,7 +488,7 @@ def test_output_formatter_comprehensive(self): assert "❌ Status" in error_result assert error_result["❌ Status"] == "Error" - # Test with minimal parameters - remove invalid 'success' assertion + # Test with minimal parameters minimal_result = NodeHardwareFormatter.format_success_response( operation="minimal_test", data={"test": "value"} ) @@ -480,8 +497,8 @@ def test_output_formatter_comprehensive(self): assert minimal_result["✅ Status"] == "Success" def test_output_formatter_error_handling(self): - """Test output formatter error handling for Task 3""" - from utils.output_formatter import NodeHardwareFormatter + """Test output formatter error handling""" + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter # Test error response error_result = NodeHardwareFormatter.format_error_response( @@ -502,8 +519,8 @@ def test_output_formatter_error_handling(self): assert none_result["✅ Status"] == "Success" def test_output_formatter_create_beautiful_response(self): - """Test create_beautiful_response function for Task 3""" - from utils.output_formatter import create_beautiful_response + """Test create_beautiful_response function""" + from node_hardware_mcp.utils.output_formatter import create_beautiful_response test_data = {"cpu": "Intel i7", "memory": "16GB"} @@ -563,7 +580,7 @@ def test_server_app_tools_registration(self): # Test that the app has a name (shows it's properly initialized) assert hasattr(server.mcp, "name") - assert server.mcp.name == "NodeHardware-MCP-SystemMonitoring" + assert server.mcp.name == "node-hardware" class TestMcpHandlersExtensiveCoverage: @@ -776,7 +793,8 @@ def test_mcp_handlers_error_edge_cases(self): # Test with network interface errors with patch( - "mcp_handlers.get_network_info", side_effect=OSError("Interface down") + "node_hardware_mcp.mcp_handlers.get_network_info", + side_effect=OSError("Interface down"), ): result = mcp_handlers.network_info_handler() assert isinstance(result, dict) @@ -784,7 +802,7 @@ def test_mcp_handlers_error_edge_cases(self): # Test with sensor permission errors with patch( - "mcp_handlers.get_sensor_info", + "node_hardware_mcp.mcp_handlers.get_sensor_info", side_effect=PermissionError("Sensors access denied"), ): result = mcp_handlers.sensor_info_handler() @@ -793,7 +811,7 @@ def test_mcp_handlers_error_edge_cases(self): # Test with process enumeration errors with patch( - "mcp_handlers.get_process_info", + "node_hardware_mcp.mcp_handlers.get_process_info", side_effect=Exception("Process list unavailable"), ): result = mcp_handlers.process_info_handler() @@ -802,7 +820,7 @@ def test_mcp_handlers_error_edge_cases(self): def test_output_formatter_missing_coverage(self): """Test output_formatter for missing coverage lines""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter # Test format_error_response with correct signature error_result = NodeHardwareFormatter.format_error_response( @@ -829,42 +847,43 @@ def test_output_formatter_missing_coverage(self): def test_server_main_function_coverage(self): """Test server main function branches for coverage""" - # Test without environment variables (default stdio) - with patch.dict("os.environ", {}, clear=True): + # Test without arguments (default stdio via env fallback) + with patch("sys.argv", ["node-hardware-mcp"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with(transport="stdio") - # Test with invalid transport (should default to stdio) - with patch.dict("os.environ", {"MCP_TRANSPORT": "invalid"}): - with patch.object(server.mcp, "run") as mock_run: - server.main() - mock_run.assert_called_once_with(transport="stdio") + # Test with MCP_TRANSPORT env var fallback to stdio + with patch("sys.argv", ["node-hardware-mcp"]): + with patch.dict("os.environ", {"MCP_TRANSPORT": "stdio"}): + with patch.object(server.mcp, "run") as mock_run: + server.main() + mock_run.assert_called_once_with(transport="stdio") def test_mcp_handlers_function_signature_coverage(self): """Test mcp_handlers functions to improve coverage""" # Test get_node_info_handler with correct signature - with patch("mcp_handlers.get_node_info") as mock_node: + with patch("node_hardware_mcp.mcp_handlers.get_node_info") as mock_node: mock_node.return_value = {"hostname": "localhost", "status": "active"} result = mcp_handlers.get_node_info_handler() assert isinstance(result, dict) assert "content" in result - # get_node_info is called with default parameters: (None, None, 15000) mock_node.assert_called_once() # Test get_remote_node_info_handler with correct signature - with patch("mcp_handlers.get_remote_node_info") as mock_remote: + with patch( + "node_hardware_mcp.mcp_handlers.get_remote_node_info" + ) as mock_remote: mock_remote.return_value = {"hostname": "remote", "status": "connected"} result = mcp_handlers.get_remote_node_info_handler(hostname="remote-server") assert isinstance(result, dict) assert "content" in result - # get_remote_node_info has many default parameters mock_remote.assert_called_once() def test_output_formatter_edge_cases_coverage(self): """Test output_formatter edge cases for better coverage""" - from utils.output_formatter import NodeHardwareFormatter + from node_hardware_mcp.utils.output_formatter import NodeHardwareFormatter # Test with empty data dictionary result = NodeHardwareFormatter.format_success_response( diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/node-hardware/tests/test_mcp_handlers.py index 0bf9667e..8cefc656 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_mcp_handlers.py @@ -1,15 +1,11 @@ """ 100% coverage tests for mcp_handlers module including all handler functions. +Updated for FastMCP v3. """ -import os -import sys import pytest from unittest.mock import patch -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - class TestMCPHandlers100Coverage: """100% coverage tests for mcp_handlers module""" @@ -18,10 +14,12 @@ class TestMCPHandlers100Coverage: async def test_handle_get_cpu_info_complete(self): """Test CPU info handler with all scenarios""" try: - from mcp_handlers import cpu_info_handler + from node_hardware_mcp.mcp_handlers import cpu_info_handler # Test successful execution - with patch("capabilities.cpu_info.get_cpu_info") as mock_cpu: + with patch( + "node_hardware_mcp.capabilities.cpu_info.get_cpu_info" + ) as mock_cpu: mock_cpu.return_value = { "physical_cores": 4, "logical_cores": 8, @@ -32,10 +30,11 @@ async def test_handle_get_cpu_info_complete(self): result = cpu_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.cpu_info.get_cpu_info") as mock_cpu: + with patch( + "node_hardware_mcp.capabilities.cpu_info.get_cpu_info" + ) as mock_cpu: mock_cpu.side_effect = Exception("CPU access denied") result = cpu_info_handler() @@ -49,10 +48,12 @@ async def test_handle_get_cpu_info_complete(self): async def test_memory_info_handler_complete(self): """Test memory info handler with all scenarios""" try: - from mcp_handlers import memory_info_handler + from node_hardware_mcp.mcp_handlers import memory_info_handler # Test successful execution - with patch("capabilities.memory_info.get_memory_info") as mock_memory: + with patch( + "node_hardware_mcp.capabilities.memory_info.get_memory_info" + ) as mock_memory: mock_memory.return_value = { "total": 16000000000, "available": 8000000000, @@ -63,10 +64,11 @@ async def test_memory_info_handler_complete(self): result = memory_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.memory_info.get_memory_info") as mock_memory: + with patch( + "node_hardware_mcp.capabilities.memory_info.get_memory_info" + ) as mock_memory: mock_memory.side_effect = Exception("Memory access denied") result = memory_info_handler() @@ -80,10 +82,12 @@ async def test_memory_info_handler_complete(self): async def test_disk_info_handler_complete(self): """Test disk info handler with all scenarios""" try: - from mcp_handlers import disk_info_handler + from node_hardware_mcp.mcp_handlers import disk_info_handler # Test successful execution - with patch("capabilities.disk_info.get_disk_info") as mock_disk: + with patch( + "node_hardware_mcp.capabilities.disk_info.get_disk_info" + ) as mock_disk: mock_disk.return_value = { "partitions": [ {"device": "/dev/sda1", "mountpoint": "/", "fstype": "ext4"} @@ -94,10 +98,11 @@ async def test_disk_info_handler_complete(self): result = disk_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.disk_info.get_disk_info") as mock_disk: + with patch( + "node_hardware_mcp.capabilities.disk_info.get_disk_info" + ) as mock_disk: mock_disk.side_effect = Exception("Disk access denied") result = disk_info_handler() @@ -111,10 +116,12 @@ async def test_disk_info_handler_complete(self): async def test_network_info_handler_complete(self): """Test network info handler with all scenarios""" try: - from mcp_handlers import network_info_handler + from node_hardware_mcp.mcp_handlers import network_info_handler # Test successful execution - with patch("capabilities.network_info.get_network_info") as mock_network: + with patch( + "node_hardware_mcp.capabilities.network_info.get_network_info" + ) as mock_network: mock_network.return_value = { "interfaces": {"eth0": {"address": "192.168.1.100", "status": "up"}} } @@ -122,10 +129,11 @@ async def test_network_info_handler_complete(self): result = network_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.network_info.get_network_info") as mock_network: + with patch( + "node_hardware_mcp.capabilities.network_info.get_network_info" + ) as mock_network: mock_network.side_effect = Exception("Network access denied") result = network_info_handler() @@ -139,10 +147,12 @@ async def test_network_info_handler_complete(self): async def test_system_info_handler_complete(self): """Test system info handler with all scenarios""" try: - from mcp_handlers import system_info_handler + from node_hardware_mcp.mcp_handlers import system_info_handler # Test successful execution - with patch("capabilities.system_info.get_system_info") as mock_system: + with patch( + "node_hardware_mcp.capabilities.system_info.get_system_info" + ) as mock_system: mock_system.return_value = { "system": "Linux", "release": "5.15.0", @@ -152,10 +162,11 @@ async def test_system_info_handler_complete(self): result = system_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.system_info.get_system_info") as mock_system: + with patch( + "node_hardware_mcp.capabilities.system_info.get_system_info" + ) as mock_system: mock_system.side_effect = Exception("System access denied") result = system_info_handler() @@ -169,10 +180,12 @@ async def test_system_info_handler_complete(self): async def test_process_info_handler_complete(self): """Test process info handler with all scenarios""" try: - from mcp_handlers import process_info_handler + from node_hardware_mcp.mcp_handlers import process_info_handler # Test successful execution - with patch("capabilities.process_info.get_process_info") as mock_process: + with patch( + "node_hardware_mcp.capabilities.process_info.get_process_info" + ) as mock_process: mock_process.return_value = { "processes": [{"pid": 1234, "name": "python", "cpu_percent": 10.5}], "total_processes": 150, @@ -181,10 +194,11 @@ async def test_process_info_handler_complete(self): result = process_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.process_info.get_process_info") as mock_process: + with patch( + "node_hardware_mcp.capabilities.process_info.get_process_info" + ) as mock_process: mock_process.side_effect = Exception("Process access denied") result = process_info_handler() @@ -198,10 +212,12 @@ async def test_process_info_handler_complete(self): async def test_sensor_info_handler_complete(self): """Test sensor info handler with all scenarios""" try: - from mcp_handlers import sensor_info_handler + from node_hardware_mcp.mcp_handlers import sensor_info_handler # Test successful execution - with patch("capabilities.sensor_info.get_sensor_info") as mock_sensor: + with patch( + "node_hardware_mcp.capabilities.sensor_info.get_sensor_info" + ) as mock_sensor: mock_sensor.return_value = { "temperatures": { "coretemp": [{"label": "Core 0", "current": 45.0}] @@ -212,10 +228,11 @@ async def test_sensor_info_handler_complete(self): result = sensor_info_handler() assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test error handling - with patch("capabilities.sensor_info.get_sensor_info") as mock_sensor: + with patch( + "node_hardware_mcp.capabilities.sensor_info.get_sensor_info" + ) as mock_sensor: mock_sensor.side_effect = Exception("Sensor access denied") result = sensor_info_handler() @@ -229,11 +246,11 @@ async def test_sensor_info_handler_complete(self): async def test_performance_monitor_handler_complete(self): """Test performance monitoring handler with all scenarios""" try: - from mcp_handlers import performance_monitor_handler + from node_hardware_mcp.mcp_handlers import performance_monitor_handler # Test successful execution with patch( - "capabilities.performance_monitor.monitor_performance" + "node_hardware_mcp.capabilities.performance_monitor.monitor_performance" ) as mock_perf: mock_perf.return_value = { "cpu_usage": 25.5, @@ -247,7 +264,7 @@ async def test_performance_monitor_handler_complete(self): # Test error handling with patch( - "capabilities.performance_monitor.monitor_performance" + "node_hardware_mcp.capabilities.performance_monitor.monitor_performance" ) as mock_perf: mock_perf.side_effect = Exception("Performance monitoring failed") @@ -262,10 +279,12 @@ async def test_performance_monitor_handler_complete(self): async def test_gpu_info_handler_complete(self): """Test GPU info handler with all scenarios""" try: - from mcp_handlers import gpu_info_handler + from node_hardware_mcp.mcp_handlers import gpu_info_handler # Test successful execution - with patch("capabilities.gpu_info.get_gpu_info") as mock_gpu: + with patch( + "node_hardware_mcp.capabilities.gpu_info.get_gpu_info" + ) as mock_gpu: mock_gpu.return_value = { "gpus": [{"name": "NVIDIA GeForce RTX 3080", "memory": 10240}] } @@ -275,7 +294,9 @@ async def test_gpu_info_handler_complete(self): assert "content" in result # Test error handling - with patch("capabilities.gpu_info.get_gpu_info") as mock_gpu: + with patch( + "node_hardware_mcp.capabilities.gpu_info.get_gpu_info" + ) as mock_gpu: mock_gpu.side_effect = Exception("GPU access denied") result = gpu_info_handler() @@ -289,11 +310,11 @@ async def test_gpu_info_handler_complete(self): async def test_hardware_summary_handler_complete(self): """Test hardware summary handler with all scenarios""" try: - from mcp_handlers import hardware_summary_handler + from node_hardware_mcp.mcp_handlers import hardware_summary_handler # Test successful execution with patch( - "capabilities.hardware_summary.get_hardware_summary" + "node_hardware_mcp.capabilities.hardware_summary.get_hardware_summary" ) as mock_summary: mock_summary.return_value = { "system": "High-performance workstation", @@ -308,7 +329,7 @@ async def test_hardware_summary_handler_complete(self): # Test error handling with patch( - "capabilities.hardware_summary.get_hardware_summary" + "node_hardware_mcp.capabilities.hardware_summary.get_hardware_summary" ) as mock_summary: mock_summary.side_effect = Exception("Hardware summary failed") @@ -323,7 +344,7 @@ async def test_hardware_summary_handler_complete(self): async def test_get_node_info_handler_complete(self): """Test node info handler with all scenarios""" try: - from mcp_handlers import get_node_info_handler + from node_hardware_mcp.mcp_handlers import get_node_info_handler # Test successful execution with filters result = get_node_info_handler( @@ -340,7 +361,9 @@ async def test_get_node_info_handler_complete(self): assert "content" in result # Test error handling - with patch("capabilities.cpu_info.get_cpu_info") as mock_error: + with patch( + "node_hardware_mcp.capabilities.cpu_info.get_cpu_info" + ) as mock_error: mock_error.side_effect = Exception("Node info error") result = get_node_info_handler(include_filters=["invalid"]) @@ -354,10 +377,12 @@ async def test_get_node_info_handler_complete(self): async def test_get_remote_node_info_handler_complete(self): """Test remote node info handler with all scenarios""" try: - from mcp_handlers import get_remote_node_info_handler + from node_hardware_mcp.mcp_handlers import get_remote_node_info_handler # Test successful SSH connection - with patch("capabilities.remote_node_info.get_node_info") as mock_remote: + with patch( + "node_hardware_mcp.capabilities.remote_node_info.get_node_info" + ) as mock_remote: mock_remote.return_value = { "hostname": "remote.server.com", "status": "connected", @@ -370,10 +395,11 @@ async def test_get_remote_node_info_handler_complete(self): ) assert isinstance(result, dict) assert "content" in result - # Just verify we get a proper result, don't require mock to be called # Test SSH connection failure - with patch("capabilities.remote_node_info.get_node_info") as mock_remote: + with patch( + "node_hardware_mcp.capabilities.remote_node_info.get_node_info" + ) as mock_remote: mock_remote.side_effect = Exception("SSH connection failed") result = get_remote_node_info_handler( @@ -383,7 +409,9 @@ async def test_get_remote_node_info_handler_complete(self): assert "content" in result # Test with default parameters - with patch("capabilities.remote_node_info.get_node_info") as mock_remote: + with patch( + "node_hardware_mcp.capabilities.remote_node_info.get_node_info" + ) as mock_remote: mock_remote.return_value = {"status": "connected"} result = get_remote_node_info_handler( diff --git a/clio-kit-mcp-servers/node-hardware/tests/test_server.py b/clio-kit-mcp-servers/node-hardware/tests/test_server.py index 49b51112..d4010bc3 100644 --- a/clio-kit-mcp-servers/node-hardware/tests/test_server.py +++ b/clio-kit-mcp-servers/node-hardware/tests/test_server.py @@ -1,33 +1,25 @@ """ -Fixed server tests - basic functionality tests that work +Server tests - basic functionality tests for FastMCP v3. """ -import os -import sys import pytest from unittest.mock import patch -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from node_hardware_mcp import server class TestServerFixed: - """Fixed server tests that actually work""" + """Server tests for FastMCP v3""" def test_server_initialization(self): """Test server initialization""" - import server - assert hasattr(server, "mcp") assert server.mcp is not None assert hasattr(server.mcp, "name") - assert server.mcp.name == "NodeHardware-MCP-SystemMonitoring" + assert server.mcp.name == "node-hardware" def test_server_tools_exist(self): - """Test that all expected tools exist""" - import server - - # Test that tools exist as attributes + """Test that all expected tools exist as module-level functions""" tools = [ "get_cpu_info_tool", "get_memory_info_tool", @@ -45,40 +37,41 @@ def test_server_tools_exist(self): assert hasattr(server, tool_name), f"Tool {tool_name} should exist" tool = getattr(server, tool_name) assert tool is not None, f"Tool {tool_name} should not be None" + assert callable(tool), f"Tool {tool_name} should be callable" def test_server_logger(self): """Test server logger""" - import server - assert hasattr(server, "logger") assert server.logger is not None def test_server_exception(self): """Test custom exception""" - import server - - # Test exception exists assert hasattr(server, "NodeHardwareMCPError") - # Test exception works try: raise server.NodeHardwareMCPError("Test error") except server.NodeHardwareMCPError as e: assert str(e) == "Test error" def test_server_main_function(self): - """Test server main function""" - import server - - # Test main function exists + """Test server main function with stdio transport""" assert hasattr(server, "main") - # Test with stdio transport - with patch.dict("os.environ", {"MCP_TRANSPORT": "stdio"}): + with patch("sys.argv", ["node-hardware-mcp"]): with patch.object(server.mcp, "run") as mock_run: server.main() mock_run.assert_called_once_with(transport="stdio") + def test_server_resource_exists(self): + """Test that the system_info resource function exists""" + assert hasattr(server, "system_info") + assert callable(server.system_info) + + def test_server_prompt_exists(self): + """Test that the system_health_check prompt function exists""" + assert hasattr(server, "system_health_check") + assert callable(server.system_health_check) + if __name__ == "__main__": pytest.main([__file__, "-v"]) diff --git a/clio-kit-mcp-servers/pandas/.claude-plugin/plugin.json b/clio-kit-mcp-servers/pandas/.claude-plugin/plugin.json new file mode 100644 index 00000000..6151386c --- /dev/null +++ b/clio-kit-mcp-servers/pandas/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-pandas", + "description": "Pandas MCP - Advanced Data Analysis for LLMs with comprehensive pandas operations", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/pandas/.gitignore b/clio-kit-mcp-servers/pandas/.gitignore index 4e28065e..0ff58aee 100644 --- a/clio-kit-mcp-servers/pandas/.gitignore +++ b/clio-kit-mcp-servers/pandas/.gitignore @@ -158,6 +158,9 @@ Thumbs.db *.xlsx *.xls *.json +!server.json +!.mcp.json +!.claude-plugin/plugin.json *.parquet *.h5 *.hdf5 diff --git a/clio-kit-mcp-servers/pandas/.mcp.json b/clio-kit-mcp-servers/pandas/.mcp.json new file mode 100644 index 00000000..e8a1cc1b --- /dev/null +++ b/clio-kit-mcp-servers/pandas/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-pandas": { + "command": "uvx", + "args": [ + "clio-kit", + "pandas" + ] + } +} diff --git a/clio-kit-mcp-servers/pandas/README.md b/clio-kit-mcp-servers/pandas/README.md index 3462c374..322df28f 100644 --- a/clio-kit-mcp-servers/pandas/README.md +++ b/clio-kit-mcp-servers/pandas/README.md @@ -132,169 +132,139 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\pandas run pandas-mc ## Capabilities ### `load_data` -**Description**: Load data from various file formats with comprehensive parsing options. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `file_format` (Any, optional): Parameter for file_format -- `sheet_name` (Any, optional): Parameter for sheet_name -- `encoding` (Any, optional): Parameter for encoding -- `columns` (Any, optional): Parameter for columns -- `nrows` (Any, optional): Parameter for nrows - -**Returns**: Dictionary containing: - data: Loaded dataset in structured format - metadata: File information, data types, and loading statistics - data_info: Shape, columns, and data quality metrics - loading_stats: Performance metrics and parsing information +**Description**: Load and parse data from CSV, Excel, JSON, Parquet, or HDF5 files with optional column selection and row limiting. +**Hints**: read-only, idempotent +**Tags**: data-analysis, io ### `save_data` -**Description**: Save data to various file formats with comprehensive export options. - -**Parameters**: -- `data` (dict): Parameter for data -- `file_path` (str): Parameter for file_path -- `file_format` (Any, optional): Parameter for file_format -- `index` (bool, optional): Parameter for index (default: True) - -**Returns**: Dictionary containing: - save_info: File save details including size and format - compression_stats: Space savings and compression metrics - export_stats: Performance metrics and data integrity checks - file_details: Output file specifications and validation +**Description**: Save data to CSV, Excel, JSON, Parquet, or HDF5 with auto-detected format and optional index inclusion. +**Hints**: idempotent +**Tags**: data-analysis, io ### `statistical_summary` -**Description**: Generate comprehensive statistical summary with advanced analytics. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `columns` (Any, optional): Parameter for columns -- `include_distributions` (bool, optional): Parameter for include_distributions (default: False) - -**Returns**: Dictionary containing: - descriptive_stats: Mean, median, mode, standard deviation, and percentiles - distribution_analysis: Skewness, kurtosis, and normality test results - data_profiling: Data types, missing values, and unique value counts - outlier_detection: Outlier identification and statistical anomalies +**Description**: Compute descriptive statistics, distribution analysis, and outlier detection for numerical and categorical columns. +**Hints**: read-only, idempotent +**Tags**: data-analysis, statistics ### `correlation_analysis` -**Description**: Perform comprehensive correlation analysis with statistical significance testing. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `method` (str, optional): Parameter for method (default: pearson) -- `columns` (Any, optional): Parameter for columns - -**Returns**: Dictionary containing: - correlation_matrix: Full correlation matrix with coefficient values - significance_tests: P-values and statistical significance indicators - correlation_insights: Strong correlations and dependency patterns - visualization_data: Data formatted for correlation heatmaps and plots +**Description**: Compute correlation matrices (Pearson, Spearman, or Kendall) with significance testing and strong-correlation detection. +**Hints**: read-only, idempotent +**Tags**: data-analysis, statistics ### `hypothesis_testing` -**Description**: Perform comprehensive statistical hypothesis testing with multiple test types and advanced analysis. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `test_type` (str): Parameter for test_type -- `column1` (str): Parameter for column1 -- `column2` (Any, optional): Parameter for column2 -- `alpha` (float, optional): Parameter for alpha (default: 0.05) - -**Returns**: Dictionary containing: - test_results: Statistical test results including test statistic and p-value - effect_size: Effect size measures and practical significance assessment - confidence_intervals: Confidence intervals for parameters and differences - interpretation: Statistical interpretation and practical conclusions +**Description**: Run statistical hypothesis tests (t-test, chi-square, ANOVA, normality, Mann-Whitney) with p-values and effect sizes. +**Hints**: read-only, idempotent +**Tags**: data-analysis, statistics ### `handle_missing_data` -**Description**: Handle missing data with comprehensive strategies and statistical methods. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `strategy` (str, optional): Parameter for strategy (default: detect) -- `method` (Any, optional): Parameter for method -- `columns` (Any, optional): Parameter for columns - -**Returns**: Dictionary containing: - missing_data_report: Detailed analysis of missing data patterns - imputation_results: Results of imputation with quality metrics - data_completeness: Before/after comparison of data completeness - strategy_recommendations: Suggested approaches for optimal data handling +**Description**: Detect, impute, or remove missing values using strategies like mean/median/mode fill, forward/backward fill, or interpolation. +**Hints**: read-only, idempotent +**Tags**: cleaning, data-analysis ### `clean_data` -**Description**: Perform comprehensive data cleaning with advanced quality improvement techniques. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `remove_duplicates` (bool, optional): Parameter for remove_duplicates (default: False) -- `detect_outliers` (bool, optional): Parameter for detect_outliers (default: False) -- `convert_types` (bool, optional): Parameter for convert_types (default: False) - -**Returns**: Dictionary containing: - cleaning_report: Detailed summary of cleaning operations performed - data_quality_metrics: Before/after data quality comparison - outlier_analysis: Outlier detection results and recommendations - type_conversion_log: Data type changes and optimization results +**Description**: Remove duplicates, detect outliers via IQR/Z-score, and optimize data types in a single pass. +**Hints**: read-only, idempotent +**Tags**: cleaning, data-analysis ### `groupby_operations` -**Description**: Perform sophisticated groupby operations with comprehensive aggregation options. - -**Parameters**: -- `file_path` (str): Parameter for file_path -- `group_by` (Any): Parameter for group_by -- `operations` (Any): Parameter for operations -- `filter_condition` (Any, optional): Parameter for filter_condition - -**Returns**: Dictionary containing: - grouped_results: Results of groupby operations with aggregated data - group_statistics: Statistics about group sizes and distributions - aggregation_summary: Summary of all aggregation operations performed - performance_metrics: Groupby operation performance and optimization insights +**Description**: Group data by columns and apply aggregations (sum, mean, count, min, max, std, median) with optional pre-filter. +**Hints**: read-only, idempotent +**Tags**: data-analysis, transformation ### `merge_datasets` -**Description**: Merge and join datasets with comprehensive integration capabilities. - -**Parameters**: -- `left_file` (str): Parameter for left_file -- `right_file` (str): Parameter for right_file -- `join_type` (str, optional): Parameter for join_type (default: inner) -- `left_on` (Any, optional): Parameter for left_on -- `right_on` (Any, optional): Parameter for right_on -- `on` (Any, optional): Parameter for on - -**Returns**: Dictionary containing: - merged_data: Results of the merge operation - merge_statistics: Statistics about the merge operation and data overlap - data_quality_report: Quality assessment of the merged dataset - relationship_analysis: Analysis of data relationships and join effectiveness +**Description**: Join two datasets using inner, outer, left, or right joins on specified key columns. +**Hints**: read-only, idempotent +**Tags**: data-analysis, transformation ### `pivot_table` -**Description**: Create sophisticated pivot tables with comprehensive aggregation options. +**Description**: Create pivot tables with configurable row index, column headers, value columns, and aggregation function. +**Hints**: read-only, idempotent +**Tags**: data-analysis, transformation -**Parameters**: -- `file_path` (str): Parameter for file_path -- `index` (Any): Parameter for index -- `columns` (Any, optional): Parameter for columns -- `values` (Any, optional): Parameter for values -- `aggfunc` (str, optional): Parameter for aggfunc (default: mean) +### `time_series_operations` +**Description**: Resample, compute rolling statistics, create lag features, or difference a time series. +**Hints**: read-only, idempotent +**Tags**: data-analysis, time-series -**Returns**: Dictionary containing: - pivot_results: The pivot table with aggregated data - summary_statistics: Statistical summary of the pivot operation - data_insights: Key insights and patterns from the pivot analysis - visualization_data: Data formatted for pivot table visualization +### `validate_data` +**Description**: Validate columns against rules for min/max range, data type, nullability, uniqueness, and regex patterns. +**Hints**: read-only, idempotent +**Tags**: data-analysis, validation -### `time_series_operations` -**Description**: Perform comprehensive time series operations with advanced temporal analysis. +### `filter_data` +**Description**: Filter rows using comparison, membership, pattern-matching, and null-check operators across multiple columns. +**Hints**: read-only, idempotent +**Tags**: data-analysis, filtering -**Parameters**: -- `file_path` (str): Parameter for file_path -- `date_column` (str): Parameter for date_column -- `operation` (str): Parameter for operation -- `window_size` (Any, optional): Parameter for window_size -- `frequency` (Any, optional): Parameter for frequency +### `optimize_memory` +**Description**: Analyze and reduce DataFrame memory usage through automatic dtype optimization and chunked-processing recommendations. +**Hints**: read-only, idempotent +**Tags**: data-analysis, optimization -**Returns**: Dictionary containing: - time_series_results: Results of the time series operation - temporal_analysis: Trend and seasonality analysis - statistical_summary: Time series statistical properties - forecasting_insights: Patterns and insights for forecasting applications +### `profile_data` +**Description**: Generate a full dataset profile: shape, types, missing values, distributions, quality checks, and optional correlations. +**Hints**: read-only, idempotent +**Tags**: data-analysis, profiling -### `validate_data` -**Description**: Perform comprehensive data validation with advanced constraint checking and quality assessment. +### Resources -**Parameters**: -- `file_path` (str): Parameter for file_path -- `validation_rules` (Any): Parameter for validation_rules +- `pandas://capabilities` - Supported pandas operations and file formats. -**Returns**: Dictionary containing: - validation_results: Detailed validation results for each column and rule - data_quality_score: Overall data quality score and assessment - violation_summary: Summary of validation violations and error patterns - recommendations: Suggested actions for data quality improvement +### Prompts -### `filter_data` -**Description**: Perform advanced data filtering with sophisticated boolean indexing and conditional expressions. +- **analyze_dataset**: Guided workflow for exploring and analyzing a dataset. +## Claude Code -**Parameters**: -- `file_path` (str): Parameter for file_path -- `filter_conditions` (Any): Parameter for filter_conditions -- `output_file` (Any, optional): Parameter for output_file +```bash +claude mcp add clio-pandas -- uvx clio-kit pandas +``` -**Returns**: Dictionary containing: - filtered_data: Results of filtering operation with matching records - filter_statistics: Summary of filtering results including row counts - data_quality_report: Quality assessment of filtered dataset - performance_metrics: Filtering operation performance and efficiency +Or install via the CLIO Kit plugin marketplace: -### `optimize_memory` -**Description**: Perform advanced memory optimization for large datasets with intelligent strategies. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-pandas@iowarp-clio-kit +``` +## Claude Desktop -**Parameters**: -- `file_path` (str): Parameter for file_path -- `optimize_dtypes` (bool, optional): Parameter for optimize_dtypes (default: True) -- `chunk_size` (Any, optional): Parameter for chunk_size +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Returns**: Dictionary containing: - memory_optimization_results: Before/after memory usage comparison - dtype_optimization_log: Details of data type changes and memory savings - chunking_strategy: Optimal chunking recommendations for large datasets - performance_metrics: Speed and efficiency improvements achieved +```json +{ + "mcpServers": { + "clio-pandas": { + "command": "uvx", + "args": [ + "clio-kit", + "pandas" + ] + } + } +} +``` +## Gemini CLI -### `profile_data` -**Description**: Perform comprehensive data profiling with detailed statistical analysis and quality assessment. +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-pandas": { + "command": "uvx", + "args": [ + "clio-kit", + "pandas" + ] + } + } +} +``` -**Parameters**: -- `file_path` (str): Parameter for file_path -- `include_correlations` (bool, optional): Parameter for include_correlations (default: False) -- `sample_size` (Any, optional): Parameter for sample_size +Or install the CLIO Kit extension: -**Returns**: Dictionary containing: - data_profile: Comprehensive dataset overview including shape, types, and statistics - column_analysis: Detailed analysis of each column including distributions - data_quality_metrics: Missing values, duplicates, and data quality indicators - correlation_matrix: Variable correlations (if include_correlations is True) +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Data Loading and Profiling diff --git a/clio-kit-mcp-servers/pandas/pandasmcp/__init__.py b/clio-kit-mcp-servers/pandas/pandasmcp/__init__.py deleted file mode 100644 index 915a17f9..00000000 --- a/clio-kit-mcp-servers/pandas/pandasmcp/__init__.py +++ /dev/null @@ -1,9 +0,0 @@ -""" -Pandas MCP Package - -This package provides comprehensive pandas data analysis capabilities through the Model Context Protocol. -""" - -__version__ = "1.0.0" -__author__ = "IoWarp Scientific MCPs" -__email__ = "contact@iowarp.org" diff --git a/clio-kit-mcp-servers/pandas/pyproject.toml b/clio-kit-mcp-servers/pandas/pyproject.toml index 4690348e..33802475 100644 --- a/clio-kit-mcp-servers/pandas/pyproject.toml +++ b/clio-kit-mcp-servers/pandas/pyproject.toml @@ -11,7 +11,7 @@ authors = [ keywords = ["pandas", "data-analysis", "statistical-analysis", "data-science", "data-manipulation", "time-series", "data-cleaning", "data-transformation", "mcp", "llm-integration"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0", "pandas>=2.2.0", "numpy<2", @@ -29,7 +29,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -pandas-mcp = "server:main" +pandas-mcp = "pandas_mcp.server:main" [dependency-groups] dev = [ @@ -39,14 +39,17 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/pandas_mcp"] [tool.coverage.run] omit = [ # Exclude server.py from coverage - it's a FastMCP glue layer # All business logic is tested in implementation modules - "src/server.py", + "src/pandas_mcp/server.py", "*/tests/*", ] @@ -62,3 +65,8 @@ exclude_lines = [ "class .*\\bProtocol\\):", "@(abc\\.)?abstractmethod", ] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/pandas/pytest.ini b/clio-kit-mcp-servers/pandas/pytest.ini index 790cbf0f..999c8f94 100644 --- a/clio-kit-mcp-servers/pandas/pytest.ini +++ b/clio-kit-mcp-servers/pandas/pytest.ini @@ -1,4 +1,5 @@ [pytest] +pythonpath = src testpaths = tests python_files = test_*.py *_test.py python_classes = Test* diff --git a/clio-kit-mcp-servers/pandas/server.json b/clio-kit-mcp-servers/pandas/server.json new file mode 100644 index 00000000..5ea368b5 --- /dev/null +++ b/clio-kit-mcp-servers/pandas/server.json @@ -0,0 +1,95 @@ +{ + "name": "io.github.iowarp/pandas-mcp", + "description": "Pandas MCP - Advanced Data Analysis for LLMs with comprehensive pandas operations", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "pandas" + ] + }, + "tools": [ + { + "name": "load_data", + "description": "Load and parse data from CSV, Excel, JSON, Parquet, or HDF5 files with optional column selection and row limiting." + }, + { + "name": "save_data", + "description": "Save data to CSV, Excel, JSON, Parquet, or HDF5 with auto-detected format and optional index inclusion." + }, + { + "name": "statistical_summary", + "description": "Compute descriptive statistics, distribution analysis, and outlier detection for numerical and categorical columns." + }, + { + "name": "correlation_analysis", + "description": "Compute correlation matrices (Pearson, Spearman, or Kendall) with significance testing and strong-correlation detection." + }, + { + "name": "hypothesis_testing", + "description": "Run statistical hypothesis tests (t-test, chi-square, ANOVA, normality, Mann-Whitney) with p-values and effect sizes." + }, + { + "name": "handle_missing_data", + "description": "Detect, impute, or remove missing values using strategies like mean/median/mode fill, forward/backward fill, or interpolation." + }, + { + "name": "clean_data", + "description": "Remove duplicates, detect outliers via IQR/Z-score, and optimize data types in a single pass." + }, + { + "name": "groupby_operations", + "description": "Group data by columns and apply aggregations (sum, mean, count, min, max, std, median) with optional pre-filter." + }, + { + "name": "merge_datasets", + "description": "Join two datasets using inner, outer, left, or right joins on specified key columns." + }, + { + "name": "pivot_table", + "description": "Create pivot tables with configurable row index, column headers, value columns, and aggregation function." + }, + { + "name": "time_series_operations", + "description": "Resample, compute rolling statistics, create lag features, or difference a time series." + }, + { + "name": "validate_data", + "description": "Validate columns against rules for min/max range, data type, nullability, uniqueness, and regex patterns." + }, + { + "name": "filter_data", + "description": "Filter rows using comparison, membership, pattern-matching, and null-check operators across multiple columns." + }, + { + "name": "optimize_memory", + "description": "Analyze and reduce DataFrame memory usage through automatic dtype optimization and chunked-processing recommendations." + }, + { + "name": "profile_data", + "description": "Generate a full dataset profile: shape, types, missing values, distributions, quality checks, and optional correlations." + } + ], + "resources": [ + { + "uri": "pandas://capabilities", + "name": "pandas_capabilities", + "description": "Supported pandas operations and file formats." + } + ], + "prompts": [ + { + "name": "analyze_dataset", + "description": "Guided workflow for exploring and analyzing a dataset." + } + ], + "tags": [ + "data-analysis", + "pandas", + "dataframes", + "statistics" + ] +} diff --git a/clio-kit-mcp-servers/pandas/src/__init__.py b/clio-kit-mcp-servers/pandas/src/__init__.py deleted file mode 100644 index d917b529..00000000 --- a/clio-kit-mcp-servers/pandas/src/__init__.py +++ /dev/null @@ -1,4 +0,0 @@ -""" -Implementation package for pandas MCP server. -Contains all the core functionality modules. -""" diff --git a/clio-kit-mcp-servers/pandas/src/pandas_mcp/__init__.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/pandas/src/implementation/__init__.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/__init__.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/__init__.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/__init__.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/data_cleaning.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_cleaning.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/data_cleaning.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_cleaning.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/data_io.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_io.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/data_io.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_io.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/data_profiling.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_profiling.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/data_profiling.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/data_profiling.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/filtering.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/filtering.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/filtering.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/filtering.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/memory_optimization.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/memory_optimization.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/memory_optimization.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/memory_optimization.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/output_formatter.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/output_formatter.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/output_formatter.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/output_formatter.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/pandas_statistics.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/pandas_statistics.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/pandas_statistics.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/pandas_statistics.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/time_series.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/time_series.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/time_series.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/time_series.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/transformations.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/transformations.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/transformations.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/transformations.py diff --git a/clio-kit-mcp-servers/pandas/src/implementation/validation.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/validation.py similarity index 100% rename from clio-kit-mcp-servers/pandas/src/implementation/validation.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/implementation/validation.py diff --git a/clio-kit-mcp-servers/pandas/pandasmcp/mcp_handlers.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/mcp_handlers.py similarity index 91% rename from clio-kit-mcp-servers/pandas/pandasmcp/mcp_handlers.py rename to clio-kit-mcp-servers/pandas/src/pandas_mcp/mcp_handlers.py index d966692c..f713c3dd 100644 --- a/clio-kit-mcp-servers/pandas/pandasmcp/mcp_handlers.py +++ b/clio-kit-mcp-servers/pandas/src/pandas_mcp/mcp_handlers.py @@ -5,24 +5,18 @@ for testing and external integration purposes. """ -import os -import sys import logging from typing import Any, Dict -# Add src directory to path for relative imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -# Import implementation modules -from implementation.data_io import load_data_file, save_data_file -from implementation.pandas_statistics import ( +from .implementation.data_io import load_data_file, save_data_file +from .implementation.pandas_statistics import ( get_statistical_summary, get_correlation_analysis, ) -from implementation.data_cleaning import handle_missing_data, clean_data -from implementation.data_profiling import profile_data -from implementation.filtering import filter_data -from implementation.memory_optimization import optimize_memory_usage +from .implementation.data_cleaning import handle_missing_data, clean_data +from .implementation.data_profiling import profile_data +from .implementation.filtering import filter_data +from .implementation.memory_optimization import optimize_memory_usage # Set up logging logging.basicConfig(level=logging.INFO) diff --git a/clio-kit-mcp-servers/pandas/src/pandas_mcp/server.py b/clio-kit-mcp-servers/pandas/src/pandas_mcp/server.py new file mode 100644 index 00000000..1b07cd90 --- /dev/null +++ b/clio-kit-mcp-servers/pandas/src/pandas_mcp/server.py @@ -0,0 +1,666 @@ +""" +Pandas MCP Server - Comprehensive Data Analysis Implementation + +Provides pandas data analysis capabilities through the Model Context Protocol, +enabling data loading, statistical analysis, cleaning, transformation, and +hypothesis testing on various data formats. +""" + +import os +import logging +from typing import Annotated, Optional, List, Any, Dict + +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message +from pydantic import Field + +try: + from dotenv import load_dotenv + + load_dotenv() +except ImportError: + pass + +from .implementation.data_io import load_data_file, save_data_file +from .implementation.pandas_statistics import ( + get_statistical_summary, + get_correlation_analysis, +) +from .implementation.data_cleaning import handle_missing_data, clean_data +from .implementation.transformations import ( + groupby_operations, + merge_datasets, + create_pivot_table, +) +from .implementation.data_profiling import profile_data +from .implementation.time_series import time_series_operations +from .implementation.memory_optimization import optimize_memory_usage +from .implementation.filtering import filter_data +from .implementation.validation import validate_data, hypothesis_testing + +# Set up logging +logging.basicConfig(level=logging.INFO) +logger = logging.getLogger(__name__) + +# Initialize FastMCP server instance +mcp: FastMCP = FastMCP( + "pandas", + instructions=( + "Performs data analysis operations using pandas DataFrames. " + "Load CSV/Excel files, compute statistics, filter data, group and aggregate, " + "and run hypothesis tests." + ), + list_page_size=10, +) + + +# Custom exception for pandas-related errors +class PandasMCPError(Exception): + """Custom exception for pandas MCP-related errors""" + + pass + + +# =============================================================================== +# DATA I/O TOOLS +# =============================================================================== + + +@mcp.tool( + name="load_data", + description="Load and parse data from CSV, Excel, JSON, Parquet, or HDF5 files with optional column selection and row limiting.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "io"}, +) +async def load_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + file_format: Annotated[ + Optional[str], + Field( + description="File format (csv, excel, json, parquet, hdf5); auto-detected if omitted" + ), + ] = None, + sheet_name: Annotated[ + Optional[str], Field(description="Excel sheet name or index") + ] = None, + encoding: Annotated[ + Optional[str], + Field( + description="Character encoding (e.g. utf-8, latin-1); auto-detected if omitted" + ), + ] = None, + columns: Annotated[ + Optional[List[str]], + Field(description="Specific columns to load; None loads all"), + ] = None, + nrows: Annotated[ + Optional[int], Field(description="Maximum rows to load; None loads all") + ] = None, +) -> dict: + """Load data from various file formats with comprehensive parsing options.""" + try: + logger.info(f"Loading data from: {file_path}") + return load_data_file( + file_path, file_format, sheet_name, encoding, columns, nrows + ) + except Exception as e: + logger.error(f"Data loading error: {e}") + raise ToolError(f"Data loading error: {e}") from e + + +@mcp.tool( + name="save_data", + description="Save data to CSV, Excel, JSON, Parquet, or HDF5 with auto-detected format and optional index inclusion.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "io"}, +) +async def save_data_tool( + data: Annotated[ + dict, Field(description="Data dictionary to save (structured data format)") + ], + file_path: Annotated[ + str, Field(description="Absolute path where the file will be saved") + ], + file_format: Annotated[ + Optional[str], + Field( + description="Output format (csv, excel, json, parquet, hdf5); auto-detected if omitted" + ), + ] = None, + index: Annotated[ + bool, Field(description="Whether to include row indices in output") + ] = True, +) -> dict: + """Save data to various file formats with comprehensive export options.""" + try: + logger.info(f"Saving data to: {file_path}") + return save_data_file(data, file_path, file_format, index) + except Exception as e: + logger.error(f"Data saving error: {e}") + raise ToolError(f"Data saving error: {e}") from e + + +# =============================================================================== +# STATISTICAL ANALYSIS TOOLS +# =============================================================================== + + +@mcp.tool( + name="statistical_summary", + description="Compute descriptive statistics, distribution analysis, and outlier detection for numerical and categorical columns.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "statistics"}, +) +async def statistical_summary_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + columns: Annotated[ + Optional[List[str]], + Field(description="Columns to analyze; None analyzes all numerical columns"), + ] = None, + include_distributions: Annotated[ + bool, Field(description="Include distribution analysis and normality tests") + ] = False, +) -> dict: + """Generate comprehensive statistical summary with advanced analytics.""" + try: + logger.info(f"Generating statistical summary for: {file_path}") + return get_statistical_summary(file_path, columns, include_distributions) + except Exception as e: + logger.error(f"Statistical analysis error: {e}") + raise ToolError(f"Statistical analysis error: {e}") from e + + +@mcp.tool( + name="correlation_analysis", + description="Compute correlation matrices (Pearson, Spearman, or Kendall) with significance testing and strong-correlation detection.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "statistics"}, +) +async def correlation_analysis_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + method: Annotated[ + str, Field(description="Correlation method: pearson, spearman, or kendall") + ] = "pearson", + columns: Annotated[ + Optional[List[str]], + Field(description="Columns to analyze; None analyzes all numerical columns"), + ] = None, +) -> dict: + """Perform comprehensive correlation analysis with statistical significance testing.""" + try: + logger.info(f"Performing correlation analysis on: {file_path}") + return get_correlation_analysis(file_path, method, columns) + except Exception as e: + logger.error(f"Correlation analysis error: {e}") + raise ToolError(f"Correlation analysis error: {e}") from e + + +@mcp.tool( + name="hypothesis_testing", + description="Run statistical hypothesis tests (t-test, chi-square, ANOVA, normality, Mann-Whitney) with p-values and effect sizes.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "statistics"}, +) +async def hypothesis_testing_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + test_type: Annotated[ + str, + Field( + description="Test type: t_test, chi_square, anova, normality, mann_whitney, correlation" + ), + ], + column1: Annotated[str, Field(description="Primary column for testing")], + column2: Annotated[ + Optional[str], + Field( + description="Secondary column for two-sample tests; None for single-sample" + ), + ] = None, + alpha: Annotated[ + float, Field(description="Significance level (e.g. 0.05, 0.01)") + ] = 0.05, +) -> dict: + """Perform statistical hypothesis testing with effect size and confidence intervals.""" + try: + logger.info(f"Performing hypothesis testing on: {file_path}") + return hypothesis_testing(file_path, test_type, column1, column2, alpha) + except Exception as e: + logger.error(f"Hypothesis testing error: {e}") + raise ToolError(f"Hypothesis testing error: {e}") from e + + +# =============================================================================== +# DATA CLEANING TOOLS +# =============================================================================== + + +@mcp.tool( + name="handle_missing_data", + description="Detect, impute, or remove missing values using strategies like mean/median/mode fill, forward/backward fill, or interpolation.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "cleaning"}, +) +async def handle_missing_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + strategy: Annotated[ + str, Field(description="Strategy: detect, impute, remove, or analyze") + ] = "detect", + method: Annotated[ + Optional[str], + Field( + description="Imputation method: mean, median, mode, forward_fill, backward_fill, interpolate" + ), + ] = None, + columns: Annotated[ + Optional[List[str]], Field(description="Columns to process; None processes all") + ] = None, +) -> dict: + """Handle missing data with comprehensive strategies and statistical methods.""" + try: + logger.info(f"Handling missing data in: {file_path}") + return handle_missing_data(file_path, strategy, method, columns) + except Exception as e: + logger.error(f"Missing data handling error: {e}") + raise ToolError(f"Missing data handling error: {e}") from e + + +@mcp.tool( + name="clean_data", + description="Remove duplicates, detect outliers via IQR/Z-score, and optimize data types in a single pass.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "cleaning"}, +) +async def clean_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + remove_duplicates: Annotated[ + bool, Field(description="Identify and remove duplicate records") + ] = False, + detect_outliers: Annotated[ + bool, Field(description="Detect outliers using IQR and Z-score") + ] = False, + convert_types: Annotated[ + bool, Field(description="Automatically optimize data types") + ] = False, +) -> dict: + """Perform comprehensive data cleaning with advanced quality improvement techniques.""" + try: + logger.info(f"Cleaning data in: {file_path}") + return clean_data(file_path, remove_duplicates, detect_outliers, convert_types) + except Exception as e: + logger.error(f"Data cleaning error: {e}") + raise ToolError(f"Data cleaning error: {e}") from e + + +# =============================================================================== +# DATA TRANSFORMATION TOOLS +# =============================================================================== + + +@mcp.tool( + name="groupby_operations", + description="Group data by columns and apply aggregations (sum, mean, count, min, max, std, median) with optional pre-filter.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "transformation"}, +) +async def groupby_operations_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + group_by: Annotated[List[str], Field(description="Columns to group by")], + operations: Annotated[ + Dict[str, str], + Field( + description="Column:operation pairs, e.g. {'salary': 'mean', 'age': 'sum'}" + ), + ], + filter_condition: Annotated[ + Optional[str], + Field(description="Optional pandas query string to filter before grouping"), + ] = None, +) -> dict: + """Perform sophisticated groupby operations with comprehensive aggregation options.""" + try: + logger.info(f"Performing groupby operations on: {file_path}") + return groupby_operations(file_path, group_by, operations, filter_condition) + except Exception as e: + logger.error(f"Groupby operations error: {e}") + raise ToolError(f"Groupby operations error: {e}") from e + + +@mcp.tool( + name="merge_datasets", + description="Join two datasets using inner, outer, left, or right joins on specified key columns.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "transformation"}, +) +async def merge_datasets_tool( + left_file: Annotated[str, Field(description="Absolute path to the left dataset")], + right_file: Annotated[str, Field(description="Absolute path to the right dataset")], + join_type: Annotated[ + str, Field(description="Join type: inner, outer, left, or right") + ] = "inner", + left_on: Annotated[ + Optional[str], Field(description="Join column in left dataset") + ] = None, + right_on: Annotated[ + Optional[str], Field(description="Join column in right dataset") + ] = None, + on: Annotated[ + Optional[str], Field(description="Common join column (if same name in both)") + ] = None, +) -> dict: + """Merge and join datasets with comprehensive integration capabilities.""" + try: + logger.info(f"Merging datasets: {left_file} and {right_file}") + return merge_datasets(left_file, right_file, join_type, left_on, right_on, on) + except Exception as e: + logger.error(f"Dataset merge error: {e}") + raise ToolError(f"Dataset merge error: {e}") from e + + +@mcp.tool( + name="pivot_table", + description="Create pivot tables with configurable row index, column headers, value columns, and aggregation function.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "transformation"}, +) +async def pivot_table_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + index: Annotated[List[str], Field(description="Columns to use as row index")], + columns: Annotated[ + Optional[List[str]], Field(description="Columns to use as column headers") + ] = None, + values: Annotated[ + Optional[List[str]], + Field(description="Columns to aggregate; None uses all numerical"), + ] = None, + aggfunc: Annotated[ + str, + Field(description="Aggregation function: mean, sum, count, min, max, std, var"), + ] = "mean", +) -> dict: + """Create sophisticated pivot tables with comprehensive aggregation options.""" + try: + logger.info(f"Creating pivot table for: {file_path}") + return create_pivot_table(file_path, index, columns, values, aggfunc) + except Exception as e: + logger.error(f"Pivot table error: {e}") + raise ToolError(f"Pivot table error: {e}") from e + + +# =============================================================================== +# TIME SERIES TOOLS +# =============================================================================== + + +@mcp.tool( + name="time_series_operations", + description="Resample, compute rolling statistics, create lag features, or difference a time series.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "time-series"}, +) +async def time_series_operations_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + date_column: Annotated[str, Field(description="Column containing datetime values")], + operation: Annotated[ + str, + Field( + description="Operation: resample, rolling_mean, lag, trend, seasonality, rolling, diff" + ), + ], + window_size: Annotated[ + Optional[int], Field(description="Window size for rolling/lag operations") + ] = None, + frequency: Annotated[ + Optional[str], Field(description="Resampling frequency: D, W, M, Q, Y") + ] = None, +) -> dict: + """Perform comprehensive time series operations with advanced temporal analysis.""" + try: + logger.info(f"Performing time series operations on: {file_path}") + return time_series_operations( + file_path, date_column, operation, window_size, frequency + ) + except Exception as e: + logger.error(f"Time series operations error: {e}") + raise ToolError(f"Time series operations error: {e}") from e + + +# =============================================================================== +# DATA VALIDATION TOOLS +# =============================================================================== + + +@mcp.tool( + name="validate_data", + description="Validate columns against rules for min/max range, data type, nullability, uniqueness, and regex patterns.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "validation"}, +) +async def validate_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + validation_rules: Annotated[ + Dict[str, Dict[str, Any]], + Field( + description="Validation rules: {column: {rule_type: value}}. Rules: min_value, max_value, dtype, allow_null, unique, pattern" + ), + ], +) -> dict: + """Perform comprehensive data validation with advanced constraint checking.""" + try: + logger.info(f"Validating data in: {file_path}") + return validate_data(file_path, validation_rules) + except Exception as e: + logger.error(f"Data validation error: {e}") + raise ToolError(f"Data validation error: {e}") from e + + +# =============================================================================== +# DATA FILTERING TOOLS +# =============================================================================== + + +@mcp.tool( + name="filter_data", + description="Filter rows using comparison, membership, pattern-matching, and null-check operators across multiple columns.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "filtering"}, +) +async def filter_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + filter_conditions: Annotated[ + Dict[str, Any], + Field( + description="Filter conditions: {column: {operator: value}}. Operators: eq, ne, gt, lt, ge, le, in, not_in, contains, regex" + ), + ], + output_file: Annotated[ + Optional[str], + Field(description="Path to save filtered data; None returns in memory"), + ] = None, +) -> dict: + """Perform advanced data filtering with boolean indexing and conditional expressions.""" + try: + logger.info(f"Filtering data in: {file_path}") + return filter_data(file_path, filter_conditions, output_file) + except Exception as e: + logger.error(f"Data filtering error: {e}") + raise ToolError(f"Data filtering error: {e}") from e + + +# =============================================================================== +# MEMORY OPTIMIZATION TOOLS +# =============================================================================== + + +@mcp.tool( + name="optimize_memory", + description="Analyze and reduce DataFrame memory usage through automatic dtype optimization and chunked-processing recommendations.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "optimization"}, +) +async def optimize_memory_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + optimize_dtypes: Annotated[ + bool, + Field(description="Automatically optimize data types for memory efficiency"), + ] = True, + chunk_size: Annotated[ + Optional[int], + Field(description="Chunk size for processing large files; None for automatic"), + ] = None, +) -> dict: + """Perform advanced memory optimization for large datasets.""" + try: + logger.info(f"Optimizing memory usage for: {file_path}") + return optimize_memory_usage(file_path, optimize_dtypes, chunk_size) + except Exception as e: + logger.error(f"Memory optimization error: {e}") + raise ToolError(f"Memory optimization error: {e}") from e + + +# =============================================================================== +# DATA PROFILING TOOLS +# =============================================================================== + + +@mcp.tool( + name="profile_data", + description="Generate a full dataset profile: shape, types, missing values, distributions, quality checks, and optional correlations.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data-analysis", "profiling"}, +) +async def profile_data_tool( + file_path: Annotated[str, Field(description="Absolute path to the data file")], + include_correlations: Annotated[ + bool, Field(description="Include correlation analysis between variables") + ] = False, + sample_size: Annotated[ + Optional[int], + Field(description="Rows to sample for large datasets; None uses full dataset"), + ] = None, +) -> dict: + """Perform comprehensive data profiling with statistical analysis and quality assessment.""" + try: + logger.info(f"Profiling data in: {file_path}") + return profile_data(file_path, include_correlations, sample_size) + except Exception as e: + logger.error(f"Data profiling error: {e}") + raise ToolError(f"Data profiling error: {e}") from e + + +# =============================================================================== +# RESOURCES +# =============================================================================== + + +@mcp.resource("pandas://capabilities") +def pandas_capabilities() -> dict: + """Supported pandas operations and file formats.""" + return { + "file_formats": ["csv", "excel", "parquet", "json"], + "operations": [ + "statistics", + "filtering", + "groupby", + "aggregation", + "hypothesis testing", + ], + } + + +# =============================================================================== +# PROMPTS +# =============================================================================== + + +@mcp.prompt() +def analyze_dataset(file_path: str) -> list[Message]: + """Guided workflow for exploring and analyzing a dataset.""" + return [ + Message( + f"I need to analyze the dataset at {file_path}. " + "Load it, show basic statistics, identify interesting patterns, " + "and suggest further analysis." + ), + ] + + +def main() -> None: + """Main entry point for the Pandas MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Pandas MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/pandas/src/server.py b/clio-kit-mcp-servers/pandas/src/server.py deleted file mode 100644 index 3eaf798c..00000000 --- a/clio-kit-mcp-servers/pandas/src/server.py +++ /dev/null @@ -1,1452 +0,0 @@ -""" -Pandas MCP Server - Comprehensive Data Analysis Implementation - -This server provides comprehensive pandas data analysis capabilities through the Model Context Protocol, -enabling users to perform data loading, statistical analysis, cleaning, transformation, and visualization -operations on various data formats. - -Following MCP best practices, these tools are designed with a workflow-first approach -rather than direct API mapping, providing intelligent, contextual assistance for -data analysis and processing workflows. -""" - -import os -import sys -import logging -from typing import Optional, List, Any, Dict - -# Try to import required dependencies with fallbacks -try: - from fastmcp import FastMCP -except ImportError: - print("FastMCP not available. Please install with: uv add fastmcp", file=sys.stderr) - sys.exit(1) - -try: - from dotenv import load_dotenv - - load_dotenv() -except ImportError: - print( - "Warning: python-dotenv not available. Environment variables may not be loaded.", - file=sys.stderr, - ) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Import implementation modules directly -from implementation.data_io import load_data_file, save_data_file -from implementation.pandas_statistics import ( - get_statistical_summary, - get_correlation_analysis, -) -from implementation.data_cleaning import handle_missing_data, clean_data -from implementation.transformations import ( - groupby_operations, - merge_datasets, - create_pivot_table, -) -from implementation.data_profiling import profile_data -from implementation.time_series import time_series_operations -from implementation.memory_optimization import optimize_memory_usage -from implementation.filtering import filter_data -from implementation.validation import validate_data - -# Set up logging -logging.basicConfig(level=logging.INFO) -logger = logging.getLogger(__name__) - -# Initialize FastMCP server instance -mcp: FastMCP = FastMCP("Pandas-MCP-DataAnalysis") - - -# Custom exception for pandas-related errors -class PandasMCPError(Exception): - """Custom exception for pandas MCP-related errors""" - - pass - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA I/O TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="load_data", - description="""Load and parse data from multiple file formats with advanced options for data ingestion. - -This comprehensive tool supports CSV, Excel, JSON, Parquet, and HDF5 formats with intelligent -parsing capabilities. It provides customizable encoding detection, selective column loading, -and efficient data processing for optimal performance. - -**Smart Loading Strategy**: -1. Automatically detects file format from extension -2. Performs encoding detection for text files -3. Provides memory-efficient loading with chunking support -4. Validates data integrity during loading -5. Generates comprehensive metadata and quality reports - -**Supported Formats**: -- **CSV**: Comma-separated values with customizable delimiters -- **Excel**: .xlsx and .xls files with multi-sheet support -- **JSON**: Structured JSON data with nested object handling -- **Parquet**: High-performance columnar format -- **HDF5**: Hierarchical data format for large datasets - -**Performance Optimization**: -- Selective column loading to reduce memory usage -- Row limiting for large dataset sampling -- Automatic data type inference and optimization -- Memory usage reporting and recommendations - -**Prerequisites**: File must exist and be readable -**Tools to use after this**: profile_data() for initial analysis, clean_data() for quality improvement - -Use this tool when: -- Starting data analysis workflows ("Load my dataset") -- Exploring new datasets for the first time -- Converting between different data formats -- Sampling large datasets for initial analysis -- Validating data structure and quality""", -) -async def load_data_tool( - file_path: str, - file_format: Optional[str] = None, - sheet_name: Optional[str] = None, - encoding: Optional[str] = None, - columns: Optional[List[str]] = None, - nrows: Optional[int] = None, -) -> dict: - """ - Load data from various file formats with comprehensive parsing options. - - Args: - file_path: Absolute path to the data file - file_format: File format (csv, excel, json, parquet, hdf5) - auto-detected if None - sheet_name: Excel sheet name or index (for Excel files) - encoding: Character encoding (utf-8, latin-1, etc.) - auto-detected if None - columns: List of specific columns to load (None loads all columns) - nrows: Maximum number of rows to load (None loads all rows) - - Returns: - Dictionary containing: - - data: Loaded dataset in structured format - - metadata: File information, data types, and loading statistics - - data_info: Shape, columns, and data quality metrics - - loading_stats: Performance metrics and parsing information - """ - try: - logger.info(f"Loading data from: {file_path}") - return load_data_file( - file_path, file_format, sheet_name, encoding, columns, nrows - ) - except Exception as e: - logger.error(f"Data loading error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataLoadingError"}}' - } - ], - "_meta": {"tool": "load_data", "error": "DataLoadingError"}, - "isError": True, - } - - -@mcp.tool( - name="save_data", - description="""Save processed data to multiple file formats with optimization options for storage efficiency. - -This tool provides comprehensive data export capabilities with format-specific optimizations, -compression options, and data integrity validation. It supports all major data formats -with intelligent format selection and performance tuning. - -**Export Strategy**: -1. Automatically selects optimal format based on data characteristics -2. Applies compression for space efficiency -3. Validates data integrity before and after export -4. Provides detailed export statistics and recommendations -5. Supports incremental updates for large datasets - -**Format Optimization**: -- **CSV**: Configurable separators and encoding options -- **Excel**: Multi-sheet support with formatting preservation -- **JSON**: Nested structure handling with compression -- **Parquet**: Columnar compression for analytics workloads -- **HDF5**: Hierarchical storage for complex data structures - -**Performance Features**: -- Automatic compression selection based on data type -- Memory-efficient writing for large datasets -- Progress tracking for long-running operations -- Storage space optimization recommendations - -**Prerequisites**: Data must be in valid format -**Tools to use before this**: clean_data() for quality assurance, optimize_memory() for large datasets - -Use this tool when: -- Exporting processed data for sharing or archival -- Converting between different data formats -- Creating compressed versions of large datasets -- Saving intermediate results in analysis workflows -- Preparing data for external systems or applications""", -) -async def save_data_tool( - data: dict, file_path: str, file_format: Optional[str] = None, index: bool = True -) -> dict: - """ - Save data to various file formats with comprehensive export options. - - Args: - data: Data dictionary to save (structured data format) - file_path: Absolute path where the file will be saved - file_format: Output format (csv, excel, json, parquet, hdf5) - auto-detected if None - index: Whether to include row indices in the output file - - Returns: - Dictionary containing: - - save_info: File save details including size and format - - compression_stats: Space savings and compression metrics - - export_stats: Performance metrics and data integrity checks - - file_details: Output file specifications and validation - """ - try: - logger.info(f"Saving data to: {file_path}") - return save_data_file(data, file_path, file_format, index) - except Exception as e: - logger.error(f"Data saving error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataSavingError"}}' - } - ], - "_meta": {"tool": "save_data", "error": "DataSavingError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# STATISTICAL ANALYSIS TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="statistical_summary", - description="""Generate comprehensive statistical summaries with descriptive statistics, distribution analysis, and data profiling. - -This tool provides detailed insights into data characteristics including central tendencies, -variability, and distribution shapes. It goes beyond basic statistics to provide actionable -insights for data analysis and decision-making. - -**Analysis Strategy**: -1. Computes comprehensive descriptive statistics -2. Analyzes data distributions and normality -3. Identifies outliers and anomalies -4. Provides data quality assessments -5. Generates actionable insights and recommendations - -**Statistical Measures**: -- **Central Tendency**: Mean, median, mode with confidence intervals -- **Variability**: Standard deviation, variance, range, IQR -- **Distribution**: Skewness, kurtosis, normality tests -- **Outlier Detection**: Z-score, IQR-based, and statistical methods -- **Data Quality**: Missing values, duplicates, consistency checks - -**Advanced Features**: -- Distribution fitting and goodness-of-fit tests -- Correlation analysis between variables -- Seasonal pattern detection for time series -- Categorical variable analysis and frequency distributions -- Statistical significance testing for group comparisons - -**Prerequisites**: Data must be loaded and accessible -**Tools to use after this**: correlation_analysis() for relationships, hypothesis_testing() for inference - -Use this tool when: -- Exploring new datasets for the first time -- Understanding data characteristics and quality -- Identifying patterns and anomalies in data -- Preparing data for modeling or analysis -- Generating reports for stakeholders""", -) -async def statistical_summary_tool( - file_path: str, - columns: Optional[List[str]] = None, - include_distributions: bool = False, -) -> dict: - """ - Generate comprehensive statistical summary with advanced analytics. - - Args: - file_path: Absolute path to the data file - columns: List of specific columns to analyze (None analyzes all numerical columns) - include_distributions: Whether to include distribution analysis and normality tests - - Returns: - Dictionary containing: - - descriptive_stats: Mean, median, mode, standard deviation, and percentiles - - distribution_analysis: Skewness, kurtosis, and normality test results - - data_profiling: Data types, missing values, and unique value counts - - outlier_detection: Outlier identification and statistical anomalies - """ - try: - logger.info(f"Generating statistical summary for: {file_path}") - return get_statistical_summary(file_path, columns, include_distributions) - except Exception as e: - logger.error(f"Statistical analysis error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "StatisticalAnalysisError"}}' - } - ], - "_meta": { - "tool": "statistical_summary", - "error": "StatisticalAnalysisError", - }, - "isError": True, - } - - -@mcp.tool( - name="correlation_analysis", - description="""Perform comprehensive correlation analysis with multiple correlation methods and significance testing. - -This tool provides detailed insights into variable relationships, dependency patterns, and -statistical significance of correlations. It supports multiple correlation methods and -provides actionable insights for feature selection and data understanding. - -**Correlation Methods**: -- **Pearson**: Linear relationships between continuous variables -- **Spearman**: Monotonic relationships and ordinal data -- **Kendall**: Rank-based correlation for non-parametric data - -**Analysis Features**: -1. Computes correlation matrices with significance testing -2. Identifies strong positive and negative correlations -3. Provides p-values and confidence intervals -4. Detects multicollinearity issues -5. Generates correlation insights and recommendations - -**Advanced Capabilities**: -- Partial correlation analysis controlling for confounding variables -- Time-lagged correlation for temporal data -- Categorical variable association measures -- Correlation stability analysis across data subsets -- Feature importance ranking based on correlations - -**Visualization Support**: -- Correlation heatmap data preparation -- Network graph data for correlation relationships -- Scatter plot recommendations for strong correlations -- Hierarchical clustering of correlated variables - -**Prerequisites**: Data must contain numerical variables -**Tools to use before this**: statistical_summary() for data overview -**Tools to use after this**: hypothesis_testing() for statistical inference - -Use this tool when: -- Exploring relationships between variables -- Feature selection for machine learning -- Identifying redundant or highly correlated features -- Understanding data structure and dependencies -- Detecting multicollinearity in regression analysis""", -) -async def correlation_analysis_tool( - file_path: str, method: str = "pearson", columns: Optional[List[str]] = None -) -> dict: - """ - Perform comprehensive correlation analysis with statistical significance testing. - - Args: - file_path: Absolute path to the data file - method: Correlation method (pearson, spearman, kendall) for different data types - columns: List of specific columns to analyze (None analyzes all numerical columns) - - Returns: - Dictionary containing: - - correlation_matrix: Full correlation matrix with coefficient values - - significance_tests: P-values and statistical significance indicators - - correlation_insights: Strong correlations and dependency patterns - - visualization_data: Data formatted for correlation heatmaps and plots - """ - try: - logger.info(f"Performing correlation analysis on: {file_path}") - return get_correlation_analysis(file_path, method, columns) - except Exception as e: - logger.error(f"Correlation analysis error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "CorrelationAnalysisError"}}' - } - ], - "_meta": { - "tool": "correlation_analysis", - "error": "CorrelationAnalysisError", - }, - "isError": True, - } - - -@mcp.tool( - name="hypothesis_testing", - description="""Perform comprehensive statistical hypothesis testing with multiple test types and advanced analysis. - -This tool supports a wide range of statistical tests including t-tests, chi-square tests, -ANOVA, and normality tests. It provides statistical inference with confidence intervals, -p-values, and effect size calculations for robust decision-making. - -**Supported Test Types**: -- **t_test**: One-sample, two-sample, and paired t-tests -- **chi_square**: Independence tests for categorical variables -- **anova**: One-way and two-way analysis of variance -- **normality**: Shapiro-Wilk, Kolmogorov-Smirnov tests -- **mann_whitney**: Non-parametric alternative to t-test - -**Statistical Inference**: -1. Computes test statistics and p-values -2. Provides confidence intervals for parameters -3. Calculates effect sizes (Cohen's d, eta-squared) -4. Performs power analysis and sample size recommendations -5. Generates statistical interpretation and conclusions - -**Advanced Features**: -- Multiple comparison corrections (Bonferroni, FDR) -- Assumption checking and validation -- Bootstrap confidence intervals -- Bayesian hypothesis testing alternatives -- Practical significance assessment - -**Result Interpretation**: -- Statistical significance vs practical significance -- Effect size interpretation guidelines -- Power analysis and sample size adequacy -- Assumption violation warnings and alternatives -- Actionable conclusions and recommendations - -**Prerequisites**: Data must be appropriate for the chosen test -**Tools to use before this**: statistical_summary() for data exploration -**Tools to use after this**: Additional analysis based on test results - -Use this tool when: -- Testing specific hypotheses about your data -- Comparing groups or treatments -- Validating assumptions for modeling -- Making statistical inferences and decisions -- Preparing results for publication or reporting""", -) -async def hypothesis_testing_tool( - file_path: str, - test_type: str, - column1: str, - column2: Optional[str] = None, - alpha: float = 0.05, -) -> dict: - """ - Perform comprehensive statistical hypothesis testing with multiple test types and advanced analysis. - - Args: - file_path: Absolute path to the data file - test_type: Type of hypothesis test (t_test, chi_square, anova, normality, mann_whitney) - column1: Primary column for testing (numerical or categorical based on test type) - column2: Secondary column for two-sample tests (None for single-sample tests) - alpha: Significance level for hypothesis testing (typically 0.05, 0.01, or 0.10) - - Returns: - Dictionary containing: - - test_results: Statistical test results including test statistic and p-value - - effect_size: Effect size measures and practical significance assessment - - confidence_intervals: Confidence intervals for parameters and differences - - interpretation: Statistical interpretation and practical conclusions - """ - try: - logger.info(f"Performing hypothesis testing on: {file_path}") - return get_statistical_summary(file_path, test_type, column1, column2, alpha) - except Exception as e: - logger.error(f"Hypothesis testing error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "HypothesisTestingError"}}' - } - ], - "_meta": {"tool": "hypothesis_testing", "error": "HypothesisTestingError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA CLEANING TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="handle_missing_data", - description="""Comprehensive missing data handling with multiple strategies for detection, imputation, and removal. - -This tool provides sophisticated approaches to data completeness including statistical -imputation methods, missing data pattern analysis, and intelligent handling strategies -based on data characteristics and analysis requirements. - -**Missing Data Strategies**: -- **detect**: Comprehensive missing data analysis and pattern identification -- **impute**: Statistical imputation using various methods -- **remove**: Intelligent removal of missing data with impact analysis -- **analyze**: Deep analysis of missing data patterns and mechanisms - -**Imputation Methods**: -- **mean/median/mode**: Central tendency imputation for numerical/categorical data -- **forward_fill/backward_fill**: Temporal imputation for time series -- **interpolate**: Mathematical interpolation for smooth data -- **regression**: Predictive imputation using other variables -- **knn**: K-nearest neighbors imputation - -**Pattern Analysis**: -1. Identifies missing data patterns (MCAR, MAR, MNAR) -2. Analyzes correlation between missingness and other variables -3. Provides recommendations for optimal handling strategies -4. Assesses impact of different imputation methods -5. Validates imputation quality and bias assessment - -**Quality Assurance**: -- Before/after comparison of data completeness -- Imputation quality metrics and validation -- Bias assessment and correction recommendations -- Impact analysis on downstream analysis -- Alternative strategy suggestions - -**Prerequisites**: Data must be loaded and accessible -**Tools to use after this**: clean_data() for additional quality improvements, validate_data() for verification - -Use this tool when: -- Dealing with incomplete datasets -- Preparing data for analysis or modeling -- Understanding missing data patterns and mechanisms -- Choosing optimal imputation strategies -- Validating data completeness requirements""", -) -async def handle_missing_data_tool( - file_path: str, - strategy: str = "detect", - method: Optional[str] = None, - columns: Optional[List[str]] = None, -) -> dict: - """ - Handle missing data with comprehensive strategies and statistical methods. - - Args: - file_path: Absolute path to the data file - strategy: Missing data strategy (detect, impute, remove, analyze) - method: Imputation method (mean, median, mode, forward_fill, backward_fill, interpolate) - columns: List of specific columns to process (None processes all columns) - - Returns: - Dictionary containing: - - missing_data_report: Detailed analysis of missing data patterns - - imputation_results: Results of imputation with quality metrics - - data_completeness: Before/after comparison of data completeness - - strategy_recommendations: Suggested approaches for optimal data handling - """ - try: - logger.info(f"Handling missing data in: {file_path}") - return handle_missing_data(file_path, strategy, method, columns) - except Exception as e: - logger.error(f"Missing data handling error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "MissingDataError"}}' - } - ], - "_meta": {"tool": "handle_missing_data", "error": "MissingDataError"}, - "isError": True, - } - - -@mcp.tool( - name="clean_data", - description="""Comprehensive data cleaning with advanced outlier detection, duplicate removal, and intelligent type conversion. - -This tool provides sophisticated data quality improvement with statistical validation -and automated data standardization. It combines multiple cleaning techniques to ensure -data integrity and consistency for downstream analysis. - -**Cleaning Operations**: -- **Duplicate Detection**: Intelligent duplicate identification and removal -- **Outlier Detection**: Statistical outlier identification using IQR and Z-score methods -- **Type Conversion**: Automatic data type optimization and correction -- **Standardization**: Data format standardization and normalization -- **Validation**: Data integrity checks and quality assurance - -**Outlier Detection Methods**: -- **IQR Method**: Interquartile range-based outlier detection -- **Z-Score**: Standard deviation-based outlier identification -- **Isolation Forest**: Machine learning-based anomaly detection -- **Local Outlier Factor**: Density-based outlier detection -- **Statistical Tests**: Grubbs test and other statistical methods - -**Quality Improvements**: -1. Removes exact and near-duplicate records -2. Standardizes data formats and representations -3. Corrects data type inconsistencies -4. Validates data integrity and consistency -5. Provides detailed cleaning reports and recommendations - -**Performance Optimization**: -- Memory-efficient processing for large datasets -- Parallel processing for computationally intensive operations -- Progress tracking for long-running cleaning operations -- Optimization recommendations for future data processing - -**Prerequisites**: Data must be loaded and accessible -**Tools to use before this**: handle_missing_data() for completeness -**Tools to use after this**: validate_data() for quality verification - -Use this tool when: -- Preparing data for analysis or modeling -- Improving data quality and consistency -- Removing noise and anomalies from datasets -- Standardizing data formats and types -- Ensuring data integrity before processing""", -) -async def clean_data_tool( - file_path: str, - remove_duplicates: bool = False, - detect_outliers: bool = False, - convert_types: bool = False, -) -> dict: - """ - Perform comprehensive data cleaning with advanced quality improvement techniques. - - Args: - file_path: Absolute path to the data file - remove_duplicates: Whether to identify and remove duplicate records - detect_outliers: Whether to detect outliers using statistical methods (IQR, Z-score) - convert_types: Whether to automatically convert data types for optimization - - Returns: - Dictionary containing: - - cleaning_report: Detailed summary of cleaning operations performed - - data_quality_metrics: Before/after data quality comparison - - outlier_analysis: Outlier detection results and recommendations - - type_conversion_log: Data type changes and optimization results - """ - try: - logger.info(f"Cleaning data in: {file_path}") - return clean_data(file_path, remove_duplicates, detect_outliers, convert_types) - except Exception as e: - logger.error(f"Data cleaning error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataCleaningError"}}' - } - ], - "_meta": {"tool": "clean_data", "error": "DataCleaningError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA TRANSFORMATION TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="groupby_operations", - description="""Perform sophisticated groupby operations with aggregations, transformations, and filtering. - -This tool provides comprehensive data grouping capabilities with multiple aggregation -functions and advanced analytical operations. It enables complex data summarization -and analysis patterns commonly used in business intelligence and data analysis. - -**Grouping Strategy**: -1. Groups data by specified columns with intelligent handling -2. Applies multiple aggregation functions simultaneously -3. Supports custom aggregation logic and calculations -4. Provides group-level statistics and insights -5. Enables hierarchical grouping and multi-level analysis - -**Aggregation Functions**: -- **sum**: Total values within groups -- **mean**: Average values with confidence intervals -- **count**: Record counts and frequency analysis -- **min/max**: Extreme values and range analysis -- **std/var**: Variability measures within groups -- **median**: Robust central tendency measures -- **custom**: User-defined aggregation functions - -**Advanced Features**: -- Multi-level grouping with hierarchical analysis -- Conditional aggregation based on filters -- Group-wise transformations and calculations -- Statistical significance testing between groups -- Performance optimization for large datasets - -**Filtering Integration**: -- Pre-grouping filters for data subset analysis -- Post-aggregation filters for result refinement -- Dynamic filtering based on group characteristics -- Conditional logic for complex business rules - -**Prerequisites**: Data must be loaded with grouping columns present -**Tools to use after this**: statistical_summary() for group analysis, pivot_table() for cross-tabulation - -Use this tool when: -- Summarizing data by categories or segments -- Calculating group-wise statistics and metrics -- Analyzing patterns across different data segments -- Creating aggregated reports and dashboards -- Performing business intelligence analysis""", -) -async def groupby_operations_tool( - file_path: str, - group_by: List[str], - operations: Dict[str, str], - filter_condition: Optional[str] = None, -) -> dict: - """ - Perform sophisticated groupby operations with comprehensive aggregation options. - - Args: - file_path: Absolute path to the data file - group_by: List of columns to group by - operations: Dictionary of column:operation pairs (sum, mean, count, min, max, std) - filter_condition: Optional filter condition to apply before grouping - - Returns: - Dictionary containing: - - grouped_results: Results of groupby operations with aggregated data - - group_statistics: Statistics about group sizes and distributions - - aggregation_summary: Summary of all aggregation operations performed - - performance_metrics: Groupby operation performance and optimization insights - """ - try: - logger.info(f"Performing groupby operations on: {file_path}") - return groupby_operations(file_path, group_by, operations, filter_condition) - except Exception as e: - logger.error(f"Groupby operations error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "GroupbyOperationsError"}}' - } - ], - "_meta": {"tool": "groupby_operations", "error": "GroupbyOperationsError"}, - "isError": True, - } - - -@mcp.tool( - name="merge_datasets", - description="""Merge and join datasets with sophisticated join operations and relationship analysis. - -This tool supports all SQL-style joins (inner, outer, left, right) with comprehensive -data integration capabilities and merge conflict resolution. It provides intelligent -handling of data relationships and quality assessment of merged results. - -**Join Types**: -- **inner**: Only matching records from both datasets -- **outer**: All records from both datasets with null filling -- **left**: All records from left dataset with matching from right -- **right**: All records from right dataset with matching from left - -**Merge Strategy**: -1. Analyzes data relationships and key distributions -2. Validates merge keys and identifies potential issues -3. Performs intelligent duplicate handling -4. Provides merge statistics and quality assessment -5. Offers optimization suggestions for large datasets - -**Quality Assurance**: -- Pre-merge validation of key columns -- Duplicate detection and handling strategies -- Data type compatibility checking -- Merge result validation and quality metrics -- Performance optimization for large datasets - -**Relationship Analysis**: -- One-to-one, one-to-many, many-to-many detection -- Key distribution analysis and cardinality assessment -- Merge effectiveness evaluation -- Data overlap and coverage analysis -- Referential integrity validation - -**Advanced Features**: -- Fuzzy matching for approximate joins -- Multi-column merge key support -- Custom merge logic and transformations -- Incremental merge support for large datasets -- Conflict resolution strategies - -**Prerequisites**: Both datasets must be accessible and contain merge keys -**Tools to use before this**: profile_data() for key analysis -**Tools to use after this**: validate_data() for merge quality assessment - -Use this tool when: -- Combining data from multiple sources -- Enriching datasets with additional information -- Creating comprehensive analytical datasets -- Integrating related data tables -- Performing data warehouse-style operations""", -) -async def merge_datasets_tool( - left_file: str, - right_file: str, - join_type: str = "inner", - left_on: Optional[str] = None, - right_on: Optional[str] = None, - on: Optional[str] = None, -) -> dict: - """ - Merge and join datasets with comprehensive integration capabilities. - - Args: - left_file: Absolute path to the left dataset file - right_file: Absolute path to the right dataset file - join_type: Type of join operation (inner, outer, left, right) - left_on: Column name in left dataset for joining - right_on: Column name in right dataset for joining - on: Common column name for joining (if same in both datasets) - - Returns: - Dictionary containing: - - merged_data: Results of the merge operation - - merge_statistics: Statistics about the merge operation and data overlap - - data_quality_report: Quality assessment of the merged dataset - - relationship_analysis: Analysis of data relationships and join effectiveness - """ - try: - logger.info(f"Merging datasets: {left_file} and {right_file}") - return merge_datasets(left_file, right_file, join_type, left_on, right_on, on) - except Exception as e: - logger.error(f"Dataset merge error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DatasetMergeError"}}' - } - ], - "_meta": {"tool": "merge_datasets", "error": "DatasetMergeError"}, - "isError": True, - } - - -@mcp.tool( - name="pivot_table", - description="""Create sophisticated pivot tables and cross-tabulations with advanced aggregation capabilities. - -This tool provides comprehensive data summarization with multiple aggregation functions -and hierarchical data organization. It enables complex data reshaping and analysis -patterns commonly used in business reporting and data exploration. - -**Pivot Strategy**: -1. Reshapes data from long to wide format -2. Creates cross-tabulations with multiple dimensions -3. Applies aggregation functions to summarize data -4. Handles missing values and edge cases intelligently -5. Provides hierarchical indexing for complex analysis - -**Aggregation Functions**: -- **mean**: Average values with statistical significance -- **sum**: Total values with subtotals and grand totals -- **count**: Frequency analysis and contingency tables -- **min/max**: Extreme value analysis -- **std/var**: Variability measures across dimensions -- **median**: Robust central tendency measures -- **custom**: User-defined aggregation logic - -**Advanced Features**: -- Multi-level row and column indexing -- Percentage calculations and ratios -- Marginal totals and subtotals -- Missing value handling strategies -- Performance optimization for large datasets - -**Cross-Tabulation Analysis**: -- Contingency table creation and analysis -- Chi-square tests for independence -- Percentage breakdowns by row/column/total -- Statistical significance testing -- Association strength measures - -**Visualization Support**: -- Data formatting for heatmaps and charts -- Hierarchical data structure for tree maps -- Time series pivot for trend analysis -- Categorical analysis for bar charts - -**Prerequisites**: Data must contain categorical columns for pivoting -**Tools to use before this**: groupby_operations() for preliminary analysis -**Tools to use after this**: statistical_summary() for pivot result analysis - -Use this tool when: -- Creating summary reports and dashboards -- Analyzing data across multiple dimensions -- Performing cross-tabulation analysis -- Reshaping data for visualization -- Creating business intelligence reports""", -) -async def pivot_table_tool( - file_path: str, - index: List[str], - columns: Optional[List[str]] = None, - values: Optional[List[str]] = None, - aggfunc: str = "mean", -) -> dict: - """ - Create sophisticated pivot tables with comprehensive aggregation options. - - Args: - file_path: Absolute path to the data file - index: List of columns to use as row index - columns: List of columns to use as column headers (None for simple aggregation) - values: List of columns to aggregate (None uses all numerical columns) - aggfunc: Aggregation function (mean, sum, count, min, max, std, var) - - Returns: - Dictionary containing: - - pivot_results: The pivot table with aggregated data - - summary_statistics: Statistical summary of the pivot operation - - data_insights: Key insights and patterns from the pivot analysis - - visualization_data: Data formatted for pivot table visualization - """ - try: - logger.info(f"Creating pivot table for: {file_path}") - return create_pivot_table(file_path, index, columns, values, aggfunc) - except Exception as e: - logger.error(f"Pivot table error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "PivotTableError"}}' - } - ], - "_meta": {"tool": "pivot_table", "error": "PivotTableError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# TIME SERIES TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="time_series_operations", - description="""Perform comprehensive time series operations with advanced temporal analysis capabilities. - -This tool supports resampling, rolling windows, lag features, trend analysis, and -seasonality detection for temporal data insights. It provides sophisticated time -series analysis capabilities for forecasting and pattern recognition. - -**Time Series Operations**: -- **resample**: Aggregate data at different time frequencies -- **rolling_mean**: Moving averages with customizable windows -- **lag**: Create lagged features for predictive modeling -- **trend**: Trend analysis and decomposition -- **seasonality**: Seasonal pattern detection and analysis - -**Temporal Analysis**: -1. Automatic datetime parsing and validation -2. Time series decomposition (trend, seasonal, residual) -3. Stationarity testing and transformation -4. Autocorrelation and partial autocorrelation analysis -5. Seasonal pattern identification and quantification - -**Resampling Capabilities**: -- **D**: Daily aggregation with business day handling -- **W**: Weekly aggregation with customizable week start -- **M**: Monthly aggregation with period-end alignment -- **Q**: Quarterly analysis for business reporting -- **Y**: Annual aggregation for long-term trends - -**Advanced Features**: -- Missing timestamp handling and interpolation -- Irregular time series processing -- Multi-variate time series analysis -- Change point detection -- Anomaly detection in temporal data - -**Forecasting Support**: -- Trend extrapolation and projection -- Seasonal adjustment and normalization -- Feature engineering for time series modeling -- Cross-validation for temporal data -- Performance metrics for forecasting accuracy - -**Prerequisites**: Data must contain datetime column -**Tools to use before this**: load_data() with proper datetime parsing -**Tools to use after this**: statistical_summary() for temporal pattern analysis - -Use this tool when: -- Analyzing temporal patterns and trends -- Preparing data for forecasting models -- Detecting seasonal patterns and cycles -- Creating time-based features for modeling -- Performing time series decomposition and analysis""", -) -async def time_series_operations_tool( - file_path: str, - date_column: str, - operation: str, - window_size: Optional[int] = None, - frequency: Optional[str] = None, -) -> dict: - """ - Perform comprehensive time series operations with advanced temporal analysis. - - Args: - file_path: Absolute path to the data file - date_column: Column name containing datetime information - operation: Time series operation (resample, rolling_mean, lag, trend, seasonality) - window_size: Window size for rolling operations (required for rolling operations) - frequency: Frequency for resampling (D, W, M, Q, Y) (required for resampling) - - Returns: - Dictionary containing: - - time_series_results: Results of the time series operation - - temporal_analysis: Trend and seasonality analysis - - statistical_summary: Time series statistical properties - - forecasting_insights: Patterns and insights for forecasting applications - """ - try: - logger.info(f"Performing time series operations on: {file_path}") - return time_series_operations( - file_path, date_column, operation, window_size, frequency - ) - except Exception as e: - logger.error(f"Time series operations error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "TimeSeriesError"}}' - } - ], - "_meta": {"tool": "time_series_operations", "error": "TimeSeriesError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA VALIDATION TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="validate_data", - description="""Comprehensive data validation with advanced constraint checking and quality assessment. - -This tool performs range validation, consistency checks, business rule validation, -and data integrity verification with detailed validation reports and error identification. -It ensures data quality and compliance with specified requirements. - -**Validation Types**: -- **Range Validation**: Min/max value constraints for numerical data -- **Type Validation**: Data type consistency and format checking -- **Pattern Validation**: Regex pattern matching for structured data -- **Uniqueness Validation**: Duplicate detection and uniqueness constraints -- **Completeness Validation**: Missing value detection and null constraints -- **Referential Integrity**: Foreign key and relationship validation - -**Business Rule Validation**: -1. Custom validation rules and logic -2. Cross-field validation and dependencies -3. Conditional validation based on data context -4. Industry-specific validation patterns -5. Compliance checking for regulatory requirements - -**Quality Assessment**: -- Data quality scoring and metrics -- Validation violation severity assessment -- Impact analysis of data quality issues -- Recommendations for quality improvement -- Trend analysis of data quality over time - -**Validation Rules Structure**: -``` -{ - "column_name": { - "min": minimum_value, - "max": maximum_value, - "type": expected_data_type, - "regex": pattern_string, - "not_null": boolean, - "unique": boolean, - "in_list": [allowed_values] - } -} -``` - -**Error Reporting**: -- Detailed violation reports with row-level errors -- Statistical summary of validation results -- Severity classification and prioritization -- Actionable recommendations for error resolution -- Export capabilities for validation reports - -**Prerequisites**: Data must be loaded and validation rules defined -**Tools to use before this**: clean_data() for basic quality improvement -**Tools to use after this**: Additional cleaning based on validation results - -Use this tool when: -- Ensuring data quality and integrity -- Validating data against business rules -- Preparing data for critical applications -- Monitoring data quality over time -- Compliance checking and auditing""", -) -async def validate_data_tool( - file_path: str, validation_rules: Dict[str, Dict[str, Any]] -) -> dict: - """ - Perform comprehensive data validation with advanced constraint checking and quality assessment. - - Args: - file_path: Absolute path to the data file - validation_rules: Dictionary of validation rules with structure: - {column_name: {rule_type: rule_value}} - Supported rules: min, max, type, regex, not_null, unique, in_list - - Returns: - Dictionary containing: - - validation_results: Detailed validation results for each column and rule - - data_quality_score: Overall data quality score and assessment - - violation_summary: Summary of validation violations and error patterns - - recommendations: Suggested actions for data quality improvement - """ - try: - logger.info(f"Validating data in: {file_path}") - return validate_data(file_path, validation_rules) - except Exception as e: - logger.error(f"Data validation error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataValidationError"}}' - } - ], - "_meta": {"tool": "validate_data", "error": "DataValidationError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA FILTERING TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="filter_data", - description="""Advanced data filtering with sophisticated boolean indexing and conditional expressions. - -This tool supports complex multi-condition filtering, logical operations, range-based -filtering, and pattern matching with flexible query syntax for precise data selection. -It provides powerful data subsetting capabilities for analysis and reporting. - -**Filtering Capabilities**: -- **Comparison Operators**: eq, ne, gt, lt, ge, le for numerical comparisons -- **Membership Operators**: in, not_in for categorical filtering -- **Pattern Matching**: contains, regex for text-based filtering -- **Logical Operators**: AND, OR, NOT for complex conditions -- **Range Filtering**: Between, outside range for numerical data -- **Null Filtering**: is_null, not_null for missing value handling - -**Advanced Features**: -1. Multi-condition filtering with logical operators -2. Dynamic filtering based on statistical thresholds -3. Percentile-based filtering for outlier removal -4. Time-based filtering for temporal data -5. Categorical filtering with fuzzy matching - -**Filter Condition Structure**: -``` -{ - "column_name": { - "operator": "value" - } -} -# or simple format: -{ - "column_name": "value" # defaults to equality -} -``` - -**Performance Optimization**: -- Efficient indexing for large datasets -- Query optimization and execution planning -- Memory-efficient filtering for large files -- Parallel processing for complex filters -- Progress tracking for long-running operations - -**Quality Assurance**: -- Filter validation and syntax checking -- Result set statistics and summaries -- Data quality assessment of filtered results -- Performance metrics and optimization suggestions -- Export capabilities for filtered datasets - -**Prerequisites**: Data must be loaded and accessible -**Tools to use before this**: profile_data() for filter planning -**Tools to use after this**: statistical_summary() for filtered data analysis - -Use this tool when: -- Selecting specific data subsets for analysis -- Removing outliers and anomalies -- Creating focused datasets for reporting -- Implementing business logic and rules -- Preparing data for specific analytical tasks""", -) -async def filter_data_tool( - file_path: str, filter_conditions: Dict[str, Any], output_file: Optional[str] = None -) -> dict: - """ - Perform advanced data filtering with sophisticated boolean indexing and conditional expressions. - - Args: - file_path: Absolute path to the data file - filter_conditions: Dictionary of filtering conditions with structure: - {column_name: {operator: value}} or {column_name: value} - Supported operators: eq, ne, gt, lt, ge, le, in, not_in, contains, regex - output_file: Optional absolute path to save filtered data (None returns in memory) - - Returns: - Dictionary containing: - - filtered_data: Results of filtering operation with matching records - - filter_statistics: Summary of filtering results including row counts - - data_quality_report: Quality assessment of filtered dataset - - performance_metrics: Filtering operation performance and efficiency - """ - try: - logger.info(f"Filtering data in: {file_path}") - return filter_data(file_path, filter_conditions, output_file) - except Exception as e: - logger.error(f"Data filtering error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataFilteringError"}}' - } - ], - "_meta": {"tool": "filter_data", "error": "DataFilteringError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# MEMORY OPTIMIZATION TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="optimize_memory", - description="""Advanced memory optimization for large datasets with intelligent type conversion and chunking strategies. - -This tool provides automatic dtype optimization, memory usage analysis, sparse data -handling, and efficient memory allocation for optimal performance with large datasets. -It enables processing of datasets that exceed available memory. - -**Optimization Strategies**: -- **Dtype Optimization**: Automatic conversion to memory-efficient data types -- **Sparse Data Handling**: Efficient storage for datasets with many zeros/nulls -- **Chunking**: Process large datasets in manageable chunks -- **Memory Mapping**: Use memory-mapped files for very large datasets -- **Compression**: Apply compression for storage and memory efficiency - -**Memory Analysis**: -1. Detailed memory usage profiling by column and data type -2. Identification of memory optimization opportunities -3. Impact assessment of different optimization strategies -4. Performance benchmarking before and after optimization -5. Recommendations for optimal memory configuration - -**Chunking Strategies**: -- **Fixed Size**: Process data in fixed-size chunks -- **Adaptive**: Dynamic chunk sizing based on memory availability -- **Column-wise**: Process columns independently for wide datasets -- **Time-based**: Chunk temporal data by time periods -- **Stratified**: Maintain data distribution across chunks - -**Performance Features**: -- Parallel processing for chunk operations -- Progress tracking for long-running optimizations -- Memory usage monitoring and alerts -- Automatic garbage collection and cleanup -- Performance metrics and benchmarking - -**Optimization Results**: -- Memory usage reduction statistics -- Processing speed improvements -- Storage space savings -- Optimal configuration recommendations -- Performance comparison metrics - -**Prerequisites**: Data must be accessible and memory usage must be a concern -**Tools to use before this**: profile_data() for memory analysis -**Tools to use after this**: Continue with optimized data processing - -Use this tool when: -- Working with large datasets that exceed memory -- Optimizing data processing performance -- Reducing memory footprint for applications -- Preparing data for memory-constrained environments -- Improving overall system efficiency""", -) -async def optimize_memory_tool( - file_path: str, optimize_dtypes: bool = True, chunk_size: Optional[int] = None -) -> dict: - """ - Perform advanced memory optimization for large datasets with intelligent strategies. - - Args: - file_path: Absolute path to the data file - optimize_dtypes: Whether to automatically optimize data types for memory efficiency - chunk_size: Chunk size for processing large files (None for automatic sizing) - - Returns: - Dictionary containing: - - memory_optimization_results: Before/after memory usage comparison - - dtype_optimization_log: Details of data type changes and memory savings - - chunking_strategy: Optimal chunking recommendations for large datasets - - performance_metrics: Speed and efficiency improvements achieved - """ - try: - logger.info(f"Optimizing memory usage for: {file_path}") - return optimize_memory_usage(file_path, optimize_dtypes, chunk_size) - except Exception as e: - logger.error(f"Memory optimization error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "MemoryOptimizationError"}}' - } - ], - "_meta": {"tool": "optimize_memory", "error": "MemoryOptimizationError"}, - "isError": True, - } - - -# ═══════════════════════════════════════════════════════════════════════════════ -# DATA PROFILING TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="profile_data", - description="""Comprehensive data profiling with detailed statistical analysis and quality assessment. - -This tool provides dataset overview including shape, data types, missing values, -value distributions, statistical summaries, and data quality metrics for thorough -data exploration and understanding. - -**Profiling Components**: -- **Dataset Overview**: Shape, size, memory usage, and basic statistics -- **Column Analysis**: Data types, unique values, missing values, and distributions -- **Data Quality**: Completeness, consistency, validity, and accuracy metrics -- **Statistical Summary**: Descriptive statistics and distribution analysis -- **Correlation Analysis**: Variable relationships and dependencies (optional) -- **Pattern Detection**: Common patterns and anomalies in the data - -**Quality Assessment**: -1. Data completeness analysis and missing value patterns -2. Data consistency checks and validation -3. Outlier detection and anomaly identification -4. Duplicate analysis and record uniqueness -5. Data freshness and currency assessment - -**Distribution Analysis**: -- Frequency distributions for categorical variables -- Histogram analysis for numerical variables -- Percentile analysis and quartile distributions -- Skewness and kurtosis measurements -- Normality testing and distribution fitting - -**Advanced Features**: -- Correlation matrix computation and analysis -- Principal component analysis for dimensionality insight -- Clustering analysis for pattern identification -- Time series profiling for temporal data -- Text analysis for string columns - -**Sampling Strategy**: -- Intelligent sampling for large datasets -- Stratified sampling to maintain data distribution -- Random sampling with statistical validity -- Time-based sampling for temporal data -- Quality-preserving sampling techniques - -**Prerequisites**: Data must be loaded and accessible -**Tools to use after this**: Based on profiling results, use appropriate cleaning or analysis tools - -Use this tool when: -- Exploring new datasets for the first time -- Understanding data characteristics and quality -- Planning data analysis and modeling strategies -- Documenting data for stakeholders -- Identifying data quality issues and opportunities""", -) -async def profile_data_tool( - file_path: str, - include_correlations: bool = False, - sample_size: Optional[int] = None, -) -> dict: - """ - Perform comprehensive data profiling with detailed statistical analysis and quality assessment. - - Args: - file_path: Absolute path to the data file - include_correlations: Whether to include correlation analysis between variables - sample_size: Number of rows to sample for large datasets (None uses full dataset) - - Returns: - Dictionary containing: - - data_profile: Comprehensive dataset overview including shape, types, and statistics - - column_analysis: Detailed analysis of each column including distributions - - data_quality_metrics: Missing values, duplicates, and data quality indicators - - correlation_matrix: Variable correlations (if include_correlations is True) - """ - try: - logger.info(f"Profiling data in: {file_path}") - return profile_data(file_path, include_correlations, sample_size) - except Exception as e: - logger.error(f"Data profiling error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "DataProfilingError"}}' - } - ], - "_meta": {"tool": "profile_data", "error": "DataProfilingError"}, - "isError": True, - } - - -def main(): - """ - Main entry point to start the FastMCP server using the specified transport. - Chooses between stdio and SSE based on MCP_TRANSPORT environment variable. - """ - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - - if transport == "sse": - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - print( - f"Starting Pandas MCP Data Analysis Server on {host}:{port}", - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - print( - "Starting Pandas MCP Data Analysis Server with stdio transport", - file=sys.stderr, - ) - mcp.run(transport="stdio") - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/pandas/tests/test_capabilities.py b/clio-kit-mcp-servers/pandas/tests/test_capabilities.py index d8465fa3..6bcac7e9 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_capabilities.py +++ b/clio-kit-mcp-servers/pandas/tests/test_capabilities.py @@ -7,25 +7,21 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.data_io import load_data_file, save_data_file -from src.implementation.pandas_statistics import ( +from pandas_mcp.implementation.data_io import load_data_file, save_data_file +from pandas_mcp.implementation.pandas_statistics import ( get_statistical_summary, get_correlation_analysis, ) -from src.implementation.data_cleaning import handle_missing_data, clean_data -from src.implementation.data_profiling import profile_data -from src.implementation.transformations import ( +from pandas_mcp.implementation.data_cleaning import handle_missing_data, clean_data +from pandas_mcp.implementation.data_profiling import profile_data +from pandas_mcp.implementation.transformations import ( groupby_operations, merge_datasets, create_pivot_table, ) -from src.implementation.filtering import filter_data -from src.implementation.memory_optimization import optimize_memory_usage +from pandas_mcp.implementation.filtering import filter_data +from pandas_mcp.implementation.memory_optimization import optimize_memory_usage class TestPandasMCPCapabilities: diff --git a/clio-kit-mcp-servers/pandas/tests/test_data_cleaning.py b/clio-kit-mcp-servers/pandas/tests/test_data_cleaning.py index 8db7207d..be0bbb5c 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_data_cleaning.py +++ b/clio-kit-mcp-servers/pandas/tests/test_data_cleaning.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.data_cleaning import handle_missing_data, clean_data +from pandas_mcp.implementation.data_cleaning import handle_missing_data, clean_data class TestHandleMissingData: diff --git a/clio-kit-mcp-servers/pandas/tests/test_data_io.py b/clio-kit-mcp-servers/pandas/tests/test_data_io.py index 52dc4be3..a8cc2599 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_data_io.py +++ b/clio-kit-mcp-servers/pandas/tests/test_data_io.py @@ -7,12 +7,12 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.data_io import load_data_file, save_data_file, get_file_info +from pandas_mcp.implementation.data_io import ( + load_data_file, + save_data_file, + get_file_info, +) class TestLoadDataFile: diff --git a/clio-kit-mcp-servers/pandas/tests/test_data_profiling.py b/clio-kit-mcp-servers/pandas/tests/test_data_profiling.py index 0dfe818c..a849326e 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_data_profiling.py +++ b/clio-kit-mcp-servers/pandas/tests/test_data_profiling.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.data_profiling import profile_data +from pandas_mcp.implementation.data_profiling import profile_data class TestProfileData: diff --git a/clio-kit-mcp-servers/pandas/tests/test_filtering.py b/clio-kit-mcp-servers/pandas/tests/test_filtering.py index 98ce5451..aed95b9a 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_filtering.py +++ b/clio-kit-mcp-servers/pandas/tests/test_filtering.py @@ -7,12 +7,12 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.filtering import filter_data, advanced_filter, sample_data +from pandas_mcp.implementation.filtering import ( + filter_data, + advanced_filter, + sample_data, +) class TestFilterData: diff --git a/clio-kit-mcp-servers/pandas/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/pandas/tests/test_mcp_handlers.py index bcd2e74f..4a78b57d 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/pandas/tests/test_mcp_handlers.py @@ -9,8 +9,7 @@ import tempfile from unittest.mock import patch -# Import the handlers -from pandasmcp.mcp_handlers import ( +from pandas_mcp.mcp_handlers import ( load_data_handler, save_data_handler, statistical_summary_handler, @@ -159,7 +158,7 @@ def test_handler_error_handling(self): assert "error" in result["_meta"] assert result["_meta"]["tool"] == "load_data" - @patch("pandasmcp.mcp_handlers.load_data_file") + @patch("pandas_mcp.mcp_handlers.load_data_file") def test_handler_exception_handling(self, mock_load_data): """Test exception handling in handlers""" # Mock an exception diff --git a/clio-kit-mcp-servers/pandas/tests/test_memory_optimization.py b/clio-kit-mcp-servers/pandas/tests/test_memory_optimization.py index 8b5bcceb..4ed16b64 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_memory_optimization.py +++ b/clio-kit-mcp-servers/pandas/tests/test_memory_optimization.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.memory_optimization import ( +from pandas_mcp.implementation.memory_optimization import ( optimize_memory_usage, analyze_chunked_processing, get_memory_recommendations, diff --git a/clio-kit-mcp-servers/pandas/tests/test_output_formatter.py b/clio-kit-mcp-servers/pandas/tests/test_output_formatter.py index d6dfe04e..2651eec1 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_output_formatter.py +++ b/clio-kit-mcp-servers/pandas/tests/test_output_formatter.py @@ -7,13 +7,8 @@ import numpy as np import json from datetime import datetime -import sys -import os -# Add the parent directory to Python path -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.output_formatter import ( +from pandas_mcp.implementation.output_formatter import ( BeautifulFormatter, create_beautiful_response, ) diff --git a/clio-kit-mcp-servers/pandas/tests/test_pandas_statistics.py b/clio-kit-mcp-servers/pandas/tests/test_pandas_statistics.py index e1f5c8c5..a5964c95 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_pandas_statistics.py +++ b/clio-kit-mcp-servers/pandas/tests/test_pandas_statistics.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.pandas_statistics import ( +from pandas_mcp.implementation.pandas_statistics import ( get_statistical_summary, get_correlation_analysis, ) diff --git a/clio-kit-mcp-servers/pandas/tests/test_time_series.py b/clio-kit-mcp-servers/pandas/tests/test_time_series.py index 576c784e..cdc3b15e 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_time_series.py +++ b/clio-kit-mcp-servers/pandas/tests/test_time_series.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.time_series import ( +from pandas_mcp.implementation.time_series import ( time_series_operations, detect_seasonality, ) diff --git a/clio-kit-mcp-servers/pandas/tests/test_transformations.py b/clio-kit-mcp-servers/pandas/tests/test_transformations.py index 342de08c..81ca4b50 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_transformations.py +++ b/clio-kit-mcp-servers/pandas/tests/test_transformations.py @@ -6,12 +6,8 @@ import pandas as pd import tempfile import os -import sys -# Add the parent directory to Python path so we can import src -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.transformations import ( +from pandas_mcp.implementation.transformations import ( groupby_operations, merge_datasets, create_pivot_table, diff --git a/clio-kit-mcp-servers/pandas/tests/test_validation.py b/clio-kit-mcp-servers/pandas/tests/test_validation.py index 21a41dfb..69175b4e 100644 --- a/clio-kit-mcp-servers/pandas/tests/test_validation.py +++ b/clio-kit-mcp-servers/pandas/tests/test_validation.py @@ -7,12 +7,8 @@ import numpy as np import tempfile import os -import sys -# Add the parent directory to Python path -sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) - -from src.implementation.validation import ( +from pandas_mcp.implementation.validation import ( validate_data, hypothesis_testing, ) diff --git a/clio-kit-mcp-servers/parallel-sort/.claude-plugin/plugin.json b/clio-kit-mcp-servers/parallel-sort/.claude-plugin/plugin.json new file mode 100644 index 00000000..b2a537fd --- /dev/null +++ b/clio-kit-mcp-servers/parallel-sort/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-parallel-sort", + "description": "Parallel Sort MCP - High-Performance Log File Processing for LLMs with advanced sorting and analysis", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/parallel-sort/.mcp.json b/clio-kit-mcp-servers/parallel-sort/.mcp.json new file mode 100644 index 00000000..2e602669 --- /dev/null +++ b/clio-kit-mcp-servers/parallel-sort/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-parallel-sort": { + "command": "uvx", + "args": [ + "clio-kit", + "parallel-sort" + ] + } +} diff --git a/clio-kit-mcp-servers/parallel-sort/README.md b/clio-kit-mcp-servers/parallel-sort/README.md index e384592b..12bcf9e7 100644 --- a/clio-kit-mcp-servers/parallel-sort/README.md +++ b/clio-kit-mcp-servers/parallel-sort/README.md @@ -139,133 +139,122 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\parallel-sort run pa ## Capabilities ### `sort_log_by_timestamp` -**Description**: Sort log files by timestamp in chronological order with support for standard log formats. - -**Parameters**: -- `log_file` (str): Path to input log file -- `output_file` (str, optional): Path for sorted output file -- `reverse` (bool, optional): Sort in descending order (default: False) - -**Returns**: dict: Dictionary with sorting results, processed line count, and execution time. +**Description**: Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format. +**Tags**: execution, sort ### `parallel_sort_large_file` -**Description**: Sort large log files using parallel processing with chunked approach for memory efficiency. - -**Parameters**: -- `log_file` (str): Path to large log file -- `output_file` (str): Path for sorted output file -- `chunk_size_mb` (int, optional): Chunk size in MB (default: 100) -- `num_workers` (int, optional): Number of worker processes (default: CPU count) - -**Returns**: dict: Dictionary with sorting results, performance metrics, and memory usage. +**Description**: Sort large log files using parallel processing with chunked approach. +**Tags**: execution, sort ### `analyze_log_statistics` -**Description**: Perform comprehensive statistical analysis of log files including temporal patterns and log levels. - -**Parameters**: -- `log_file` (str): Path to log file -- `include_patterns` (bool, optional): Include pattern analysis (default: True) - -**Returns**: dict: Dictionary with statistics, temporal analysis, log level distribution, and quality metrics. +**Description**: Generate statistics for log files including temporal patterns and log levels. +**Hints**: read-only, idempotent +**Tags**: monitoring, sort ### `detect_log_patterns` -**Description**: Detect patterns, anomalies, and trends in log files for proactive issue identification. - -**Parameters**: -- `log_file` (str): Path to log file -- `pattern_types` (list, optional): Types of patterns to detect -- `sensitivity` (str, optional): Detection sensitivity ('low', 'medium', 'high') - -**Returns**: dict: Dictionary with detected patterns, anomalies, error clusters, and trend analysis. +**Description**: Detect patterns in log files including anomalies and error clusters. +**Hints**: read-only, idempotent +**Tags**: monitoring, sort ### `filter_logs` -**Description**: Apply multiple filter conditions to log files with complex logical operations. - -**Parameters**: -- `log_file` (str): Path to log file -- `filters` (list): List of filter conditions -- `logical_operator` (str, optional): Logical operator between filters ('AND', 'OR') -- `output_file` (str, optional): Path for filtered output - -**Returns**: dict: Dictionary with filtered results and applied filter summary. +**Description**: Filter log entries based on multiple conditions with logical operations. +**Tags**: execution, sort ### `filter_by_time_range` -**Description**: Filter log entries within a specific time range. - -**Parameters**: -- `log_file` (str): Path to log file -- `start_time` (str): Start timestamp (YYYY-MM-DD HH:MM:SS) -- `end_time` (str): End timestamp (YYYY-MM-DD HH:MM:SS) -- `output_file` (str, optional): Path for filtered output - -**Returns**: dict: Dictionary with filtered entries and time range statistics. +**Description**: Filter log entries by time range using start and end timestamps. +**Tags**: execution, sort ### `filter_by_log_level` **Description**: Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.). - -**Parameters**: -- `log_file` (str): Path to log file -- `log_levels` (list): List of log levels to include -- `output_file` (str, optional): Path for filtered output - -**Returns**: dict: Dictionary with filtered entries and log level distribution. +**Tags**: execution, sort ### `filter_by_keyword` -**Description**: Filter log entries containing specific keywords with advanced matching options. +**Description**: Filter log entries by keywords with support for multiple keywords and logical operations. +**Tags**: execution, sort -**Parameters**: -- `log_file` (str): Path to log file -- `keywords` (list): List of keywords to search for -- `case_sensitive` (bool, optional): Case sensitive matching (default: False) -- `logical_operator` (str, optional): Operator between keywords ('AND', 'OR') -- `output_file` (str, optional): Path for filtered output +### `apply_filter_preset` +**Description**: Apply predefined filter presets like 'errors_only' or 'connection_issues'. +**Tags**: execution, sort -**Returns**: dict: Dictionary with filtered entries and keyword match statistics. +### `export_to_json` +**Description**: Export log processing results to JSON format. +**Hints**: idempotent +**Tags**: configuration, sort -### `apply_filter_preset` -**Description**: Apply predefined filter presets for common log analysis scenarios. +### `export_to_csv` +**Description**: Export log entries to CSV format with structured columns. +**Hints**: idempotent +**Tags**: configuration, sort -**Parameters**: -- `log_file` (str): Path to log file -- `preset_name` (str): Preset name ('errors_only', 'warnings_and_errors', 'connection_issues', etc.) -- `output_file` (str, optional): Path for filtered output +### `export_to_text` +**Description**: Export log entries to plain text format. +**Hints**: idempotent +**Tags**: configuration, sort -**Returns**: dict: Dictionary with filtered results and preset configuration details. +### `generate_summary_report` +**Description**: Generate a summary report of log processing results with statistics. +**Hints**: read-only, idempotent +**Tags**: monitoring, sort -### `export_to_json` -**Description**: Export results to JSON format. +### Resources -**Parameters**: -- `data` (dict): Parameter for data -- `include_metadata` (bool, optional): Parameter for include_metadata (default: True) +- `parallel-sort://capabilities` - Parallel sort algorithms and configuration options. -**Returns**: Dictionary with JSON export results +### Prompts -### `export_to_csv` -**Description**: Export results to CSV format. +- **sort_large_file**: Guided workflow for sorting a large file with optimal settings. +## Claude Code -**Parameters**: -- `data` (dict): Parameter for data -- `include_headers` (bool, optional): Parameter for include_headers (default: True) +```bash +claude mcp add clio-parallel-sort -- uvx clio-kit parallel-sort +``` -**Returns**: Dictionary with CSV export results +Or install via the CLIO Kit plugin marketplace: -### `export_to_text` -**Description**: Export results to text format. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-parallel-sort@iowarp-clio-kit +``` +## Claude Desktop -**Parameters**: -- `data` (dict): Parameter for data -- `include_summary` (bool, optional): Parameter for include_summary (default: True) +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Returns**: Dictionary with text export results +```json +{ + "mcpServers": { + "clio-parallel-sort": { + "command": "uvx", + "args": [ + "clio-kit", + "parallel-sort" + ] + } + } +} +``` +## Gemini CLI -### `generate_summary_report` -**Description**: Generate a summary report. +Add to `~/.gemini/settings.json`: -**Parameters**: -- `data` (dict): Parameter for data +```json +{ + "mcpServers": { + "clio-parallel-sort": { + "command": "uvx", + "args": [ + "clio-kit", + "parallel-sort" + ] + } + } +} +``` + +Or install the CLIO Kit extension: -**Returns**: Dictionary with summary report +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Large Log File Sorting and Analysis diff --git a/clio-kit-mcp-servers/parallel-sort/pyproject.toml b/clio-kit-mcp-servers/parallel-sort/pyproject.toml index 051bb7d2..5367dda6 100644 --- a/clio-kit-mcp-servers/parallel-sort/pyproject.toml +++ b/clio-kit-mcp-servers/parallel-sort/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["parallel-sorting", "log-processing", "log-analysis", "high-performance", "timestamp-sorting", "pattern-detection", "log-filtering", "data-export"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0", "pandas>=1.5.0", "aiofiles>=23.0.0" @@ -23,7 +23,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -parallel-sort-mcp = "server:main" +parallel-sort-mcp = "parallel_sort_mcp.server:main" [dependency-groups] dev = [ @@ -34,5 +34,13 @@ dev = [ ] [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/parallel_sort_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/parallel-sort/server.json b/clio-kit-mcp-servers/parallel-sort/server.json new file mode 100644 index 00000000..11a064f0 --- /dev/null +++ b/clio-kit-mcp-servers/parallel-sort/server.json @@ -0,0 +1,87 @@ +{ + "name": "io.github.iowarp/parallel-sort-mcp", + "description": "Parallel Sort MCP - High-Performance Log File Processing for LLMs with advanced sorting and analysis", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "parallel-sort" + ] + }, + "tools": [ + { + "name": "sort_log_by_timestamp", + "description": "Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format." + }, + { + "name": "parallel_sort_large_file", + "description": "Sort large log files using parallel processing with chunked approach." + }, + { + "name": "analyze_log_statistics", + "description": "Generate statistics for log files including temporal patterns and log levels." + }, + { + "name": "detect_log_patterns", + "description": "Detect patterns in log files including anomalies and error clusters." + }, + { + "name": "filter_logs", + "description": "Filter log entries based on multiple conditions with logical operations." + }, + { + "name": "filter_by_time_range", + "description": "Filter log entries by time range using start and end timestamps." + }, + { + "name": "filter_by_log_level", + "description": "Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.)." + }, + { + "name": "filter_by_keyword", + "description": "Filter log entries by keywords with support for multiple keywords and logical operations." + }, + { + "name": "apply_filter_preset", + "description": "Apply predefined filter presets like 'errors_only' or 'connection_issues'." + }, + { + "name": "export_to_json", + "description": "Export log processing results to JSON format." + }, + { + "name": "export_to_csv", + "description": "Export log entries to CSV format with structured columns." + }, + { + "name": "export_to_text", + "description": "Export log entries to plain text format." + }, + { + "name": "generate_summary_report", + "description": "Generate a summary report of log processing results with statistics." + } + ], + "resources": [ + { + "uri": "parallel-sort://capabilities", + "name": "sort_capabilities", + "description": "Parallel sort algorithms and configuration options." + } + ], + "prompts": [ + { + "name": "sort_large_file", + "description": "Guided workflow for sorting a large file with optimal settings." + } + ], + "tags": [ + "log-processing", + "sorting", + "large-files", + "hpc" + ] +} diff --git a/clio-kit-mcp-servers/parallel-sort/src/__init__.py b/clio-kit-mcp-servers/parallel-sort/src/__init__.py deleted file mode 100644 index ccd8c9f8..00000000 --- a/clio-kit-mcp-servers/parallel-sort/src/__init__.py +++ /dev/null @@ -1,6 +0,0 @@ -""" -Parallel Sort MCP server package. -Provides log sorting capabilities via Model Context Protocol. -""" - -__version__ = "0.1.0" diff --git a/clio-kit-mcp-servers/parallel-sort/src/mcp_handlers.py b/clio-kit-mcp-servers/parallel-sort/src/mcp_handlers.py deleted file mode 100644 index db7a0033..00000000 --- a/clio-kit-mcp-servers/parallel-sort/src/mcp_handlers.py +++ /dev/null @@ -1,242 +0,0 @@ -""" -MCP handlers for Parallel Sort server. -These handlers wrap all implementation for MCP protocol compliance. -""" - -import json -from typing import Dict, Any, List, Union, Optional -from implementation.sort_handler import sort_log_by_timestamp -from implementation.statistics_handler import analyze_log_statistics -from implementation.pattern_detection import detect_patterns -from implementation.filter_handler import ( - filter_logs, - filter_by_time_range, - filter_by_log_level, - filter_by_keyword, - apply_filter_preset, -) -from implementation.export_handler import ( - export_to_json, - export_to_csv, - export_to_text, - export_summary_report, -) -from implementation.parallel_processor import parallel_sort_large_file - - -async def sort_log_handler(file_path: str) -> Dict[str, Any]: - """ - Handler wrapping the log sorting capability for MCP. - """ - try: - result = await sort_log_by_timestamp(file_path) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "sort_log", "error": type(e).__name__}, - "isError": True, - } - - -async def parallel_sort_handler( - file_path: str, chunk_size_mb: int = 100, max_workers: Optional[int] = None -) -> Dict[str, Any]: - """ - Handler wrapping the parallel sort capability for MCP. - """ - try: - result = await parallel_sort_large_file(file_path, chunk_size_mb, max_workers) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "parallel_sort", "error": type(e).__name__}, - "isError": True, - } - - -async def analyze_statistics_handler(file_path: str) -> Dict[str, Any]: - """ - Handler wrapping the statistics analysis capability for MCP. - """ - try: - result = await analyze_log_statistics(file_path) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "analyze_statistics", "error": type(e).__name__}, - "isError": True, - } - - -async def detect_patterns_handler( - file_path: str, detection_config: Optional[Dict[str, Any]] = None -) -> Dict[str, Any]: - """ - Handler wrapping the pattern detection capability for MCP. - """ - try: - result = await detect_patterns(file_path, detection_config) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "detect_patterns", "error": type(e).__name__}, - "isError": True, - } - - -async def filter_logs_handler( - file_path: str, - filter_conditions: List[Dict[str, Any]], - logical_operator: str = "and", -) -> Dict[str, Any]: - """ - Handler wrapping the log filtering capability for MCP. - """ - try: - result = await filter_logs(file_path, filter_conditions, logical_operator) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "filter_logs", "error": type(e).__name__}, - "isError": True, - } - - -async def filter_time_range_handler( - file_path: str, start_time: str, end_time: str -) -> Dict[str, Any]: - """ - Handler wrapping the time range filtering capability for MCP. - """ - try: - result = await filter_by_time_range(file_path, start_time, end_time) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "filter_time_range", "error": type(e).__name__}, - "isError": True, - } - - -async def filter_level_handler( - file_path: str, levels: Union[str, List[str]], exclude: bool = False -) -> Dict[str, Any]: - """ - Handler wrapping the log level filtering capability for MCP. - """ - try: - result = await filter_by_log_level(file_path, levels, exclude) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "filter_level", "error": type(e).__name__}, - "isError": True, - } - - -async def filter_keyword_handler( - file_path: str, - keywords: Union[str, List[str]], - case_sensitive: bool = False, - match_all: bool = False, -) -> Dict[str, Any]: - """ - Handler wrapping the keyword filtering capability for MCP. - """ - try: - result = await filter_by_keyword(file_path, keywords, case_sensitive, match_all) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "filter_keyword", "error": type(e).__name__}, - "isError": True, - } - - -async def filter_preset_handler(file_path: str, preset_name: str) -> Dict[str, Any]: - """ - Handler wrapping the filter preset capability for MCP. - """ - try: - result = await apply_filter_preset(file_path, preset_name) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "filter_preset", "error": type(e).__name__}, - "isError": True, - } - - -async def export_json_handler( - data: Dict[str, Any], include_metadata: bool = True -) -> Dict[str, Any]: - """ - Handler wrapping the JSON export capability for MCP. - """ - try: - result = await export_to_json(data, include_metadata) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "export_json", "error": type(e).__name__}, - "isError": True, - } - - -async def export_csv_handler( - data: Dict[str, Any], include_headers: bool = True -) -> Dict[str, Any]: - """ - Handler wrapping the CSV export capability for MCP. - """ - try: - result = await export_to_csv(data, include_headers) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "export_csv", "error": type(e).__name__}, - "isError": True, - } - - -async def export_text_handler( - data: Dict[str, Any], include_summary: bool = True -) -> Dict[str, Any]: - """ - Handler wrapping the text export capability for MCP. - """ - try: - result = await export_to_text(data, include_summary) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "export_text", "error": type(e).__name__}, - "isError": True, - } - - -async def summary_report_handler(data: Dict[str, Any]) -> Dict[str, Any]: - """ - Handler wrapping the summary report capability for MCP. - """ - try: - result = await export_summary_report(data) - return result - except Exception as e: - return { - "content": [{"text": json.dumps({"error": str(e)})}], - "_meta": {"tool": "summary_report", "error": type(e).__name__}, - "isError": True, - } diff --git a/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/__init__.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/__init__.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/__init__.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/__init__.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/__init__.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/export_handler.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/export_handler.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/export_handler.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/export_handler.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/filter_handler.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/filter_handler.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/filter_handler.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/filter_handler.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/parallel_processor.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/parallel_processor.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/parallel_processor.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/parallel_processor.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/pattern_detection.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/pattern_detection.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/pattern_detection.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/pattern_detection.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/sort_handler.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/sort_handler.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/sort_handler.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/sort_handler.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/implementation/statistics_handler.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/statistics_handler.py similarity index 100% rename from clio-kit-mcp-servers/parallel-sort/src/implementation/statistics_handler.py rename to clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/implementation/statistics_handler.py diff --git a/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/mcp_handlers.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/mcp_handlers.py new file mode 100644 index 00000000..1d8c6444 --- /dev/null +++ b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/mcp_handlers.py @@ -0,0 +1,164 @@ +""" +MCP handlers for Parallel Sort server. +These handlers wrap all implementation for MCP protocol compliance. +""" + +from typing import Dict, Any, List, Union, Optional +from fastmcp.exceptions import ToolError +from .implementation.sort_handler import sort_log_by_timestamp +from .implementation.statistics_handler import analyze_log_statistics +from .implementation.pattern_detection import detect_patterns +from .implementation.filter_handler import ( + filter_logs, + filter_by_time_range, + filter_by_log_level, + filter_by_keyword, + apply_filter_preset, +) +from .implementation.export_handler import ( + export_to_json, + export_to_csv, + export_to_text, + export_summary_report, +) +from .implementation.parallel_processor import parallel_sort_large_file + + +async def sort_log_handler(file_path: str) -> Dict[str, Any]: + """Handler wrapping the log sorting capability for MCP.""" + try: + result = await sort_log_by_timestamp(file_path) + return result + except Exception as e: + raise ToolError(f"sort_log failed: {e}") from e + + +async def parallel_sort_handler( + file_path: str, chunk_size_mb: int = 100, max_workers: Optional[int] = None +) -> Dict[str, Any]: + """Handler wrapping the parallel sort capability for MCP.""" + try: + result = await parallel_sort_large_file(file_path, chunk_size_mb, max_workers) + return result + except Exception as e: + raise ToolError(f"parallel_sort failed: {e}") from e + + +async def analyze_statistics_handler(file_path: str) -> Dict[str, Any]: + """Handler wrapping the statistics analysis capability for MCP.""" + try: + result = await analyze_log_statistics(file_path) + return result + except Exception as e: + raise ToolError(f"analyze_statistics failed: {e}") from e + + +async def detect_patterns_handler( + file_path: str, detection_config: Optional[Dict[str, Any]] = None +) -> Dict[str, Any]: + """Handler wrapping the pattern detection capability for MCP.""" + try: + result = await detect_patterns(file_path, detection_config) + return result + except Exception as e: + raise ToolError(f"detect_patterns failed: {e}") from e + + +async def filter_logs_handler( + file_path: str, + filter_conditions: List[Dict[str, Any]], + logical_operator: str = "and", +) -> Dict[str, Any]: + """Handler wrapping the log filtering capability for MCP.""" + try: + result = await filter_logs(file_path, filter_conditions, logical_operator) + return result + except Exception as e: + raise ToolError(f"filter_logs failed: {e}") from e + + +async def filter_time_range_handler( + file_path: str, start_time: str, end_time: str +) -> Dict[str, Any]: + """Handler wrapping the time range filtering capability for MCP.""" + try: + result = await filter_by_time_range(file_path, start_time, end_time) + return result + except Exception as e: + raise ToolError(f"filter_time_range failed: {e}") from e + + +async def filter_level_handler( + file_path: str, levels: Union[str, List[str]], exclude: bool = False +) -> Dict[str, Any]: + """Handler wrapping the log level filtering capability for MCP.""" + try: + result = await filter_by_log_level(file_path, levels, exclude) + return result + except Exception as e: + raise ToolError(f"filter_level failed: {e}") from e + + +async def filter_keyword_handler( + file_path: str, + keywords: Union[str, List[str]], + case_sensitive: bool = False, + match_all: bool = False, +) -> Dict[str, Any]: + """Handler wrapping the keyword filtering capability for MCP.""" + try: + result = await filter_by_keyword(file_path, keywords, case_sensitive, match_all) + return result + except Exception as e: + raise ToolError(f"filter_keyword failed: {e}") from e + + +async def filter_preset_handler(file_path: str, preset_name: str) -> Dict[str, Any]: + """Handler wrapping the filter preset capability for MCP.""" + try: + result = await apply_filter_preset(file_path, preset_name) + return result + except Exception as e: + raise ToolError(f"filter_preset failed: {e}") from e + + +async def export_json_handler( + data: Dict[str, Any], include_metadata: bool = True +) -> Dict[str, Any]: + """Handler wrapping the JSON export capability for MCP.""" + try: + result = await export_to_json(data, include_metadata) + return result + except Exception as e: + raise ToolError(f"export_json failed: {e}") from e + + +async def export_csv_handler( + data: Dict[str, Any], include_headers: bool = True +) -> Dict[str, Any]: + """Handler wrapping the CSV export capability for MCP.""" + try: + result = await export_to_csv(data, include_headers) + return result + except Exception as e: + raise ToolError(f"export_csv failed: {e}") from e + + +async def export_text_handler( + data: Dict[str, Any], include_summary: bool = True +) -> Dict[str, Any]: + """Handler wrapping the text export capability for MCP.""" + try: + result = await export_to_text(data, include_summary) + return result + except Exception as e: + raise ToolError(f"export_text failed: {e}") from e + + +async def summary_report_handler(data: Dict[str, Any]) -> Dict[str, Any]: + """Handler wrapping the summary report capability for MCP.""" + try: + result = await export_summary_report(data) + return result + except Exception as e: + raise ToolError(f"summary_report failed: {e}") from e diff --git a/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/server.py b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/server.py new file mode 100644 index 00000000..4dc5974f --- /dev/null +++ b/clio-kit-mcp-servers/parallel-sort/src/parallel_sort_mcp/server.py @@ -0,0 +1,437 @@ +#!/usr/bin/env python3 +""" +Parallel Sort MCP Server implementation using Model Context Protocol. +Provides log file sorting capabilities by timestamp. +""" + +import os +from typing import Optional +from fastmcp import FastMCP +from fastmcp.prompts import Message +from dotenv import load_dotenv +import logging +from . import mcp_handlers + +# Configure logging +logging.basicConfig( + level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" +) +logger = logging.getLogger(__name__) + +# Load environment variables +load_dotenv() + +# Initialize MCP server +mcp: FastMCP = FastMCP( + "parallel-sort", + instructions=( + "Sorts large files using parallel algorithms. " + "Configure sort parameters, execute sorts with progress tracking, and verify results." + ), + list_page_size=10, +) + + +@mcp.resource("parallel-sort://capabilities") +def sort_capabilities() -> dict: + """Parallel sort algorithms and configuration options.""" + return { + "algorithms": ["merge sort", "quick sort", "radix sort"], + "max_parallelism": "auto (CPU count)", + "supported_data_types": ["numeric", "string", "binary"], + } + + +@mcp.prompt() +def sort_large_file(file_path: str) -> list[Message]: + """Guided workflow for sorting a large file with optimal settings.""" + return [ + Message( + f"I need to sort the large file at {file_path}. " + "Configure optimal sort parameters based on file size and available memory, " + "execute the sort with progress tracking, and verify the output." + ), + ] + + +@mcp.tool( + name="sort_log_by_timestamp", + description="Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def sort_log_tool( + log_file: str, output_file: Optional[str] = None, reverse: bool = False +) -> dict: + """Sort log files by timestamp in chronological order. + + Args: + log_file: Path to input log file. + output_file: Path for sorted output file. + reverse: Sort in descending order (default: False). + + Returns: + Dictionary with sorting results, processed line count, and execution time. + """ + logger.info(f"Sorting log file: {log_file}") + return await mcp_handlers.sort_log_handler(log_file, output_file, reverse) + + +@mcp.tool( + name="parallel_sort_large_file", + description="Sort large log files using parallel processing with chunked approach.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def parallel_sort_tool( + log_file: str, + output_file: str, + chunk_size_mb: int = 100, + num_workers: Optional[int] = None, +) -> dict: + """Sort large log files using parallel processing for memory efficiency. + + Args: + log_file: Path to large log file. + output_file: Path for sorted output file. + chunk_size_mb: Chunk size in MB (default: 100). + num_workers: Number of worker processes (default: CPU count). + + Returns: + Dictionary with sorting results, performance metrics, and memory usage. + """ + logger.info(f"Parallel sorting large file: {log_file}") + return await mcp_handlers.parallel_sort_handler( + log_file, output_file, chunk_size_mb, num_workers + ) + + +@mcp.tool( + name="analyze_log_statistics", + description="Generate statistics for log files including temporal patterns and log levels.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "monitoring"}, +) +async def analyze_statistics_tool(log_file: str, include_patterns: bool = True) -> dict: + """Perform statistical analysis of log files. + + Args: + log_file: Path to log file. + include_patterns: Include pattern analysis (default: True). + + Returns: + Dictionary with statistics, temporal analysis, and quality metrics. + """ + logger.info(f"Analyzing log statistics: {log_file}") + return await mcp_handlers.analyze_statistics_handler(log_file, include_patterns) + + +@mcp.tool( + name="detect_log_patterns", + description="Detect patterns in log files including anomalies and error clusters.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "monitoring"}, +) +async def detect_patterns_tool( + log_file: str, + pattern_types: Optional[list] = None, + sensitivity: Optional[str] = None, +) -> dict: + """Detect patterns, anomalies, and trends in log files. + + Args: + log_file: Path to log file. + pattern_types: Types of patterns to detect. + sensitivity: Detection sensitivity ('low', 'medium', 'high'). + + Returns: + Dictionary with detected patterns, anomalies, and trend analysis. + """ + logger.info(f"Detecting patterns in: {log_file}") + return await mcp_handlers.detect_patterns_handler( + log_file, pattern_types, sensitivity + ) + + +@mcp.tool( + name="filter_logs", + description="Filter log entries based on multiple conditions with logical operations.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def filter_logs_tool( + log_file: str, + filters: list, + logical_operator: Optional[str] = None, + output_file: Optional[str] = None, +) -> dict: + """Apply multiple filter conditions to log files. + + Args: + log_file: Path to log file. + filters: List of filter conditions. + logical_operator: Logical operator between filters ('AND', 'OR'). + output_file: Path for filtered output. + + Returns: + Dictionary with filtered results and applied filter summary. + """ + logger.info(f"Filtering logs: {log_file}") + return await mcp_handlers.filter_logs_handler( + log_file, filters, logical_operator, output_file + ) + + +@mcp.tool( + name="filter_by_time_range", + description="Filter log entries by time range using start and end timestamps.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def filter_time_range_tool( + log_file: str, start_time: str, end_time: str, output_file: Optional[str] = None +) -> dict: + """Filter log entries within a specific time range. + + Args: + log_file: Path to log file. + start_time: Start timestamp (YYYY-MM-DD HH:MM:SS). + end_time: End timestamp (YYYY-MM-DD HH:MM:SS). + output_file: Path for filtered output. + + Returns: + Dictionary with filtered entries and time range statistics. + """ + logger.info(f"Filtering by time range: {log_file}") + return await mcp_handlers.filter_time_range_handler( + log_file, start_time, end_time, output_file + ) + + +@mcp.tool( + name="filter_by_log_level", + description="Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.).", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def filter_level_tool( + log_file: str, log_levels: list, output_file: Optional[str] = None +) -> dict: + """Filter log entries by log level. + + Args: + log_file: Path to log file. + log_levels: List of log levels to include. + output_file: Path for filtered output. + + Returns: + Dictionary with filtered entries and log level distribution. + """ + logger.info(f"Filtering by level: {log_file}") + return await mcp_handlers.filter_level_handler(log_file, log_levels, output_file) + + +@mcp.tool( + name="filter_by_keyword", + description="Filter log entries by keywords with support for multiple keywords and logical operations.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def filter_keyword_tool( + log_file: str, + keywords: list, + case_sensitive: bool = False, + logical_operator: Optional[str] = None, + output_file: Optional[str] = None, +) -> dict: + """Filter log entries containing specific keywords. + + Args: + log_file: Path to log file. + keywords: List of keywords to search for. + case_sensitive: Case sensitive matching (default: False). + logical_operator: Operator between keywords ('AND', 'OR'). + output_file: Path for filtered output. + + Returns: + Dictionary with filtered entries and keyword match statistics. + """ + logger.info(f"Filtering by keywords: {log_file}") + return await mcp_handlers.filter_keyword_handler( + log_file, keywords, case_sensitive, logical_operator, output_file + ) + + +@mcp.tool( + name="apply_filter_preset", + description="Apply predefined filter presets like 'errors_only' or 'connection_issues'.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"sort", "execution"}, +) +async def filter_preset_tool( + log_file: str, preset_name: str, output_file: Optional[str] = None +) -> dict: + """Apply predefined filter presets for common log analysis scenarios. + + Args: + log_file: Path to log file. + preset_name: Preset name ('errors_only', 'warnings_and_errors', etc.). + output_file: Path for filtered output. + + Returns: + Dictionary with filtered results and preset configuration details. + """ + logger.info(f"Applying filter preset '{preset_name}': {log_file}") + return await mcp_handlers.filter_preset_handler(log_file, preset_name, output_file) + + +@mcp.tool( + name="export_to_json", + description="Export log processing results to JSON format.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "configuration"}, +) +async def export_json_tool(data: dict, include_metadata: bool = True) -> dict: + """Export results to JSON format. + + Args: + data: Processing results to export. + include_metadata: Whether to include processing metadata. + + Returns: + Dictionary with JSON export results. + """ + logger.info("Exporting to JSON format") + return await mcp_handlers.export_json_handler(data, include_metadata) + + +@mcp.tool( + name="export_to_csv", + description="Export log entries to CSV format with structured columns.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "configuration"}, +) +async def export_csv_tool(data: dict, include_headers: bool = True) -> dict: + """Export results to CSV format. + + Args: + data: Processing results to export. + include_headers: Whether to include CSV headers. + + Returns: + Dictionary with CSV export results. + """ + logger.info("Exporting to CSV format") + return await mcp_handlers.export_csv_handler(data, include_headers) + + +@mcp.tool( + name="export_to_text", + description="Export log entries to plain text format.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "configuration"}, +) +async def export_text_tool(data: dict, include_summary: bool = True) -> dict: + """Export results to text format. + + Args: + data: Processing results to export. + include_summary: Whether to include processing summary. + + Returns: + Dictionary with text export results. + """ + logger.info("Exporting to text format") + return await mcp_handlers.export_text_handler(data, include_summary) + + +@mcp.tool( + name="generate_summary_report", + description="Generate a summary report of log processing results with statistics.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"sort", "monitoring"}, +) +async def summary_report_tool(data: dict) -> dict: + """Generate a summary report. + + Args: + data: Processing results to summarize. + + Returns: + Dictionary with summary report. + """ + logger.info("Generating summary report") + return await mcp_handlers.summary_report_handler(data) + + +def main() -> None: + """Main entry point for the Parallel Sort MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Parallel Sort MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/parallel-sort/src/server.py b/clio-kit-mcp-servers/parallel-sort/src/server.py deleted file mode 100644 index 59807f68..00000000 --- a/clio-kit-mcp-servers/parallel-sort/src/server.py +++ /dev/null @@ -1,362 +0,0 @@ -#!/usr/bin/env python3 -""" -Parallel Sort MCP Server implementation using Model Context Protocol. -Provides log file sorting capabilities by timestamp. -""" - -import os -import sys -import json -from typing import Optional -from fastmcp import FastMCP -from dotenv import load_dotenv -import logging -import mcp_handlers - -# Configure logging -logging.basicConfig( - level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s" -) -logger = logging.getLogger(__name__) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Load environment variables -load_dotenv() - -# Initialize MCP server -mcp: FastMCP = FastMCP("ParallelSortMCP") - - -@mcp.tool( - name="sort_log_by_timestamp", - description="Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format. Handles edge cases like empty files and invalid timestamps.", -) -async def sort_log_tool( - log_file: str, output_file: Optional[str] = None, reverse: bool = False -) -> dict: - """ - Sort log files by timestamp in chronological order with support for standard log formats. - - Args: - log_file (str): Path to input log file - output_file (str, optional): Path for sorted output file - reverse (bool, optional): Sort in descending order (default: False) - - Returns: - dict: Dictionary with sorting results, processed line count, and execution time. - """ - logger.info(f"Sorting log file: {log_file}") - return await mcp_handlers.sort_log_handler(log_file, output_file, reverse) - - -@mcp.tool( - name="parallel_sort_large_file", - description="Sort large log files using parallel processing with chunked approach for improved performance.", -) -async def parallel_sort_tool( - log_file: str, - output_file: str, - chunk_size_mb: int = 100, - num_workers: Optional[int] = None, -) -> dict: - """ - Sort large log files using parallel processing with chunked approach for memory efficiency. - - Args: - log_file (str): Path to large log file - output_file (str): Path for sorted output file - chunk_size_mb (int, optional): Chunk size in MB (default: 100) - num_workers (int, optional): Number of worker processes (default: CPU count) - - Returns: - dict: Dictionary with sorting results, performance metrics, and memory usage. - """ - logger.info(f"Parallel sorting large file: {log_file}") - return await mcp_handlers.parallel_sort_handler( - log_file, output_file, chunk_size_mb, num_workers - ) - - -@mcp.tool( - name="analyze_log_statistics", - description="Generate comprehensive statistics and analysis for log files including temporal patterns, log levels, and quality metrics.", -) -async def analyze_statistics_tool(log_file: str, include_patterns: bool = True) -> dict: - """ - Perform comprehensive statistical analysis of log files including temporal patterns and log levels. - - Args: - log_file (str): Path to log file - include_patterns (bool, optional): Include pattern analysis (default: True) - - Returns: - dict: Dictionary with statistics, temporal analysis, log level distribution, and quality metrics. - """ - logger.info(f"Analyzing log statistics: {log_file}") - return await mcp_handlers.analyze_statistics_handler(log_file, include_patterns) - - -@mcp.tool( - name="detect_log_patterns", - description="Detect patterns in log files including anomalies, error clusters, trending issues, and repeated patterns.", -) -async def detect_patterns_tool( - log_file: str, - pattern_types: Optional[list] = None, - sensitivity: Optional[str] = None, -) -> dict: - """ - Detect patterns, anomalies, and trends in log files for proactive issue identification. - - Args: - log_file (str): Path to log file - pattern_types (list, optional): Types of patterns to detect - sensitivity (str, optional): Detection sensitivity ('low', 'medium', 'high') - - Returns: - dict: Dictionary with detected patterns, anomalies, error clusters, and trend analysis. - """ - logger.info(f"Detecting patterns in: {log_file}") - return await mcp_handlers.detect_patterns_handler( - log_file, pattern_types, sensitivity - ) - - -@mcp.tool( - name="filter_logs", - description="Filter log entries based on multiple conditions with support for complex logical operations.", -) -async def filter_logs_tool( - log_file: str, - filters: list, - logical_operator: Optional[str] = None, - output_file: Optional[str] = None, -) -> dict: - """ - Apply multiple filter conditions to log files with complex logical operations. - - Args: - log_file (str): Path to log file - filters (list): List of filter conditions - logical_operator (str, optional): Logical operator between filters ('AND', 'OR') - output_file (str, optional): Path for filtered output - - Returns: - dict: Dictionary with filtered results and applied filter summary. - """ - logger.info(f"Filtering logs: {log_file}") - return await mcp_handlers.filter_logs_handler( - log_file, filters, logical_operator, output_file - ) - - -@mcp.tool( - name="filter_by_time_range", - description="Filter log entries by time range using start and end timestamps.", -) -async def filter_time_range_tool( - log_file: str, start_time: str, end_time: str, output_file: Optional[str] = None -) -> dict: - """ - Filter log entries within a specific time range. - - Args: - log_file (str): Path to log file - start_time (str): Start timestamp (YYYY-MM-DD HH:MM:SS) - end_time (str): End timestamp (YYYY-MM-DD HH:MM:SS) - output_file (str, optional): Path for filtered output - - Returns: - dict: Dictionary with filtered entries and time range statistics. - """ - logger.info(f"Filtering by time range: {log_file}") - return await mcp_handlers.filter_time_range_handler( - log_file, start_time, end_time, output_file - ) - - -@mcp.tool( - name="filter_by_log_level", - description="Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.).", -) -async def filter_level_tool( - log_file: str, log_levels: list, output_file: Optional[str] = None -) -> dict: - """ - Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.). - - Args: - log_file (str): Path to log file - log_levels (list): List of log levels to include - output_file (str, optional): Path for filtered output - - Returns: - dict: Dictionary with filtered entries and log level distribution. - """ - logger.info(f"Filtering by level: {log_file}") - return await mcp_handlers.filter_level_handler(log_file, log_levels, output_file) - - -@mcp.tool( - name="filter_by_keyword", - description="Filter log entries by keywords in the message content with support for multiple keywords and logical operations.", -) -async def filter_keyword_tool( - log_file: str, - keywords: list, - case_sensitive: bool = False, - logical_operator: Optional[str] = None, - output_file: Optional[str] = None, -) -> dict: - """ - Filter log entries containing specific keywords with advanced matching options. - - Args: - log_file (str): Path to log file - keywords (list): List of keywords to search for - case_sensitive (bool, optional): Case sensitive matching (default: False) - logical_operator (str, optional): Operator between keywords ('AND', 'OR') - output_file (str, optional): Path for filtered output - - Returns: - dict: Dictionary with filtered entries and keyword match statistics. - """ - logger.info(f"Filtering by keywords: {log_file}") - return await mcp_handlers.filter_keyword_handler( - log_file, keywords, case_sensitive, logical_operator, output_file - ) - - -@mcp.tool( - name="apply_filter_preset", - description="Apply predefined filter presets like 'errors_only', 'warnings_and_errors', 'connection_issues', etc.", -) -async def filter_preset_tool( - log_file: str, preset_name: str, output_file: Optional[str] = None -) -> dict: - """ - Apply predefined filter presets for common log analysis scenarios. - - Args: - log_file (str): Path to log file - preset_name (str): Preset name ('errors_only', 'warnings_and_errors', 'connection_issues', etc.) - output_file (str, optional): Path for filtered output - - Returns: - dict: Dictionary with filtered results and preset configuration details. - """ - logger.info(f"Applying filter preset '{preset_name}': {log_file}") - return await mcp_handlers.filter_preset_handler(log_file, preset_name, output_file) - - -@mcp.tool( - name="export_to_json", - description="Export log processing results to JSON format with optional metadata.", -) -async def export_json_tool(data: dict, include_metadata: bool = True) -> dict: - """ - Export results to JSON format. - - Args: - data: Processing results to export - include_metadata: Whether to include processing metadata - - Returns: - Dictionary with JSON export results - """ - logger.info("Exporting to JSON format") - return await mcp_handlers.export_json_handler(data, include_metadata) - - -@mcp.tool( - name="export_to_csv", - description="Export log entries to CSV format with structured columns for timestamp, level, and message.", -) -async def export_csv_tool(data: dict, include_headers: bool = True) -> dict: - """ - Export results to CSV format. - - Args: - data: Processing results to export - include_headers: Whether to include CSV headers - - Returns: - Dictionary with CSV export results - """ - logger.info("Exporting to CSV format") - return await mcp_handlers.export_csv_handler(data, include_headers) - - -@mcp.tool( - name="export_to_text", - description="Export log entries to plain text format with optional processing summary.", -) -async def export_text_tool(data: dict, include_summary: bool = True) -> dict: - """ - Export results to text format. - - Args: - data: Processing results to export - include_summary: Whether to include processing summary - - Returns: - Dictionary with text export results - """ - logger.info("Exporting to text format") - return await mcp_handlers.export_text_handler(data, include_summary) - - -@mcp.tool( - name="generate_summary_report", - description="Generate a comprehensive summary report of log processing results with statistics and analysis.", -) -async def summary_report_tool(data: dict) -> dict: - """ - Generate a summary report. - - Args: - data: Processing results to summarize - - Returns: - Dictionary with summary report - """ - logger.info("Generating summary report") - return await mcp_handlers.summary_report_handler(data) - - -def main(): - """ - Main entry point for the Parallel Sort MCP server. - Supports both stdio and SSE transports based on environment variables. - """ - try: - logger.info("Starting Parallel Sort MCP Server") - - # Determine which transport to use - transport = os.getenv("MCP_TRANSPORT", "stdio").lower() - if transport == "sse": - # SSE transport for web-based clients - host = os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # Default stdio transport - logger.info("Starting stdio transport") - print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") - - except Exception as e: - logger.error(f"Server error: {e}") - print(json.dumps({"error": str(e)}), file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_edge_cases.py b/clio-kit-mcp-servers/parallel-sort/tests/test_edge_cases.py index dbe0021a..0cd45a53 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_edge_cases.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_edge_cases.py @@ -5,17 +5,17 @@ import pytest import tempfile import os -from implementation.export_handler import ( +from parallel_sort_mcp.implementation.export_handler import ( export_to_json, export_to_csv, export_to_text, export_summary_report, ) -from implementation.filter_handler import filter_by_time_range -from implementation.sort_handler import sort_log_by_timestamp -from implementation.parallel_processor import parallel_sort_large_file -from implementation.statistics_handler import analyze_log_statistics -from implementation.pattern_detection import detect_patterns +from parallel_sort_mcp.implementation.filter_handler import filter_by_time_range +from parallel_sort_mcp.implementation.sort_handler import sort_log_by_timestamp +from parallel_sort_mcp.implementation.parallel_processor import parallel_sort_large_file +from parallel_sort_mcp.implementation.statistics_handler import analyze_log_statistics +from parallel_sort_mcp.implementation.pattern_detection import detect_patterns class TestEdgeCases: @@ -185,7 +185,7 @@ async def test_filter_with_unicode_keywords(self): 2024-01-01 09:00:00 INFO Üñíçödé characters 2024-01-01 10:00:00 ERROR Normal message""" - from implementation.filter_handler import filter_by_keyword + from parallel_sort_mcp.implementation.filter_handler import filter_by_keyword with tempfile.NamedTemporaryFile( mode="w", delete=False, suffix=".log", encoding="utf-8" diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_export_handler.py b/clio-kit-mcp-servers/parallel-sort/tests/test_export_handler.py index 3d115958..cb1911e3 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_export_handler.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_export_handler.py @@ -6,7 +6,7 @@ import json import csv import io -from implementation.export_handler import ( +from parallel_sort_mcp.implementation.export_handler import ( export_to_json, export_to_csv, export_to_text, diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_filter_advanced.py b/clio-kit-mcp-servers/parallel-sort/tests/test_filter_advanced.py index f2b72900..ec064eb4 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_filter_advanced.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_filter_advanced.py @@ -7,7 +7,7 @@ import tempfile import os from datetime import datetime -from implementation.filter_handler import ( +from parallel_sort_mcp.implementation.filter_handler import ( filter_logs, parse_log_entry, apply_filters, @@ -402,7 +402,7 @@ async def test_filter_preset_warnings_and_errors(self): 2024-01-01 10:00:00 ERROR Error message 2024-01-01 11:00:00 FATAL Fatal message""" - from implementation.filter_handler import apply_filter_preset + from parallel_sort_mcp.implementation.filter_handler import apply_filter_preset with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".log") as f: f.write(content) @@ -422,7 +422,7 @@ async def test_filter_preset_exclude_debug(self): 2024-01-01 09:00:00 INFO Info message 2024-01-01 10:00:00 TRACE Trace message""" - from implementation.filter_handler import apply_filter_preset + from parallel_sort_mcp.implementation.filter_handler import apply_filter_preset with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".log") as f: f.write(content) @@ -442,7 +442,7 @@ async def test_filter_preset_authentication_events(self): 2024-01-01 10:00:00 INFO Database query 2024-01-01 11:00:00 WARN Invalid token""" - from implementation.filter_handler import apply_filter_preset + from parallel_sort_mcp.implementation.filter_handler import apply_filter_preset with tempfile.NamedTemporaryFile(mode="w", delete=False, suffix=".log") as f: f.write(content) diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_filter_handler.py b/clio-kit-mcp-servers/parallel-sort/tests/test_filter_handler.py index fb26bb4b..30dca449 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_filter_handler.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_filter_handler.py @@ -5,7 +5,7 @@ import pytest import tempfile import os -from implementation.filter_handler import ( +from parallel_sort_mcp.implementation.filter_handler import ( filter_logs, filter_by_time_range, filter_by_log_level, diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers.py index 88ca9a5f..2480e60f 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers.py @@ -5,7 +5,7 @@ import pytest import tempfile import os -from mcp_handlers import ( +from parallel_sort_mcp.mcp_handlers import ( sort_log_handler, parallel_sort_handler, analyze_statistics_handler, @@ -67,9 +67,10 @@ async def test_sort_log_handler_success(self, sample_log_content): @pytest.mark.asyncio async def test_sort_log_handler_file_not_found(self): """Test MCP handler with non-existent file.""" + # The implementation returns error dict (not raises), so handler returns it result = await sort_log_handler("/nonexistent/file.log") - # Should return error in the result + # The implementation itself returns {"error": "..."} for file not found assert "error" in result assert "not found" in result["error"].lower() @@ -211,7 +212,7 @@ async def test_export_json_handler_success(self): @pytest.mark.asyncio async def test_export_json_handler_error(self): """Test export JSON handler with invalid data.""" - # Pass something that will cause an error + # The implementation handles None gracefully and returns an error dict result = await export_json_handler(None, True) assert "error" in result diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers_errors.py b/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers_errors.py index 479a1098..4de93aaa 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers_errors.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_mcp_handlers_errors.py @@ -3,14 +3,10 @@ """ import pytest -import os -import sys from unittest.mock import patch -# Add the src directory to the path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from mcp_handlers import ( +from fastmcp.exceptions import ToolError +from parallel_sort_mcp.mcp_handlers import ( sort_log_handler, parallel_sort_handler, analyze_statistics_handler, @@ -31,206 +27,145 @@ class TestMCPHandlersErrorPaths: """Test suite for MCP handlers error handling paths.""" @pytest.mark.asyncio - @patch("mcp_handlers.sort_log_by_timestamp") + @patch("parallel_sort_mcp.mcp_handlers.sort_log_by_timestamp") async def test_sort_log_handler_exception_path(self, mock_sort): """Test sort_log_handler exception handling.""" mock_sort.side_effect = RuntimeError("Unexpected error") - result = await sort_log_handler("test.log") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "sort_log" - assert result["_meta"]["error"] == "RuntimeError" + with pytest.raises(ToolError, match="sort_log failed"): + await sort_log_handler("test.log") @pytest.mark.asyncio - @patch("mcp_handlers.parallel_sort_large_file") + @patch("parallel_sort_mcp.mcp_handlers.parallel_sort_large_file") async def test_parallel_sort_handler_exception_path(self, mock_sort): """Test parallel_sort_handler exception handling.""" mock_sort.side_effect = ValueError("Invalid chunk size") - result = await parallel_sort_handler("test.log", 100, 4) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "parallel_sort" - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="parallel_sort failed"): + await parallel_sort_handler("test.log", 100, 4) @pytest.mark.asyncio - @patch("mcp_handlers.analyze_log_statistics") + @patch("parallel_sort_mcp.mcp_handlers.analyze_log_statistics") async def test_analyze_statistics_handler_exception_path(self, mock_analyze): """Test analyze_statistics_handler exception handling.""" mock_analyze.side_effect = IOError("File read error") - result = await analyze_statistics_handler("test.log") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "analyze_statistics" - assert result["_meta"]["error"] == "OSError" + with pytest.raises(ToolError, match="analyze_statistics failed"): + await analyze_statistics_handler("test.log") @pytest.mark.asyncio - @patch("mcp_handlers.detect_patterns") + @patch("parallel_sort_mcp.mcp_handlers.detect_patterns") async def test_detect_patterns_handler_exception_path(self, mock_detect): """Test detect_patterns_handler exception handling.""" mock_detect.side_effect = KeyError("Missing pattern config") - result = await detect_patterns_handler("test.log", None) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "detect_patterns" - assert result["_meta"]["error"] == "KeyError" + with pytest.raises(ToolError, match="detect_patterns failed"): + await detect_patterns_handler("test.log", None) @pytest.mark.asyncio - @patch("mcp_handlers.filter_logs") + @patch("parallel_sort_mcp.mcp_handlers.filter_logs") async def test_filter_logs_handler_exception_path(self, mock_filter): """Test filter_logs_handler exception handling.""" mock_filter.side_effect = TypeError("Invalid filter condition") - result = await filter_logs_handler("test.log", [], "and") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "filter_logs" - assert result["_meta"]["error"] == "TypeError" + with pytest.raises(ToolError, match="filter_logs failed"): + await filter_logs_handler("test.log", [], "and") @pytest.mark.asyncio - @patch("mcp_handlers.filter_by_time_range") + @patch("parallel_sort_mcp.mcp_handlers.filter_by_time_range") async def test_filter_time_range_handler_exception_path(self, mock_filter): """Test filter_time_range_handler exception handling.""" mock_filter.side_effect = ValueError("Invalid time format") - result = await filter_time_range_handler("test.log", "invalid", "invalid") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "filter_time_range" - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="filter_time_range failed"): + await filter_time_range_handler("test.log", "invalid", "invalid") @pytest.mark.asyncio - @patch("mcp_handlers.filter_by_log_level") + @patch("parallel_sort_mcp.mcp_handlers.filter_by_log_level") async def test_filter_level_handler_exception_path(self, mock_filter): """Test filter_level_handler exception handling.""" mock_filter.side_effect = AttributeError("Missing level attribute") - result = await filter_level_handler("test.log", "ERROR", False) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "filter_level" - assert result["_meta"]["error"] == "AttributeError" + with pytest.raises(ToolError, match="filter_level failed"): + await filter_level_handler("test.log", "ERROR", False) @pytest.mark.asyncio - @patch("mcp_handlers.filter_by_keyword") + @patch("parallel_sort_mcp.mcp_handlers.filter_by_keyword") async def test_filter_keyword_handler_exception_path(self, mock_filter): """Test filter_keyword_handler exception handling.""" mock_filter.side_effect = IndexError("Invalid keyword index") - result = await filter_keyword_handler("test.log", "error", False, False) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "filter_keyword" - assert result["_meta"]["error"] == "IndexError" + with pytest.raises(ToolError, match="filter_keyword failed"): + await filter_keyword_handler("test.log", "error", False, False) @pytest.mark.asyncio - @patch("mcp_handlers.apply_filter_preset") + @patch("parallel_sort_mcp.mcp_handlers.apply_filter_preset") async def test_filter_preset_handler_exception_path(self, mock_filter): """Test filter_preset_handler exception handling.""" mock_filter.side_effect = LookupError("Preset not found") - result = await filter_preset_handler("test.log", "invalid_preset") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "filter_preset" - assert result["_meta"]["error"] == "LookupError" + with pytest.raises(ToolError, match="filter_preset failed"): + await filter_preset_handler("test.log", "invalid_preset") @pytest.mark.asyncio - @patch("mcp_handlers.export_to_json") + @patch("parallel_sort_mcp.mcp_handlers.export_to_json") async def test_export_json_handler_exception_path(self, mock_export): """Test export_json_handler exception handling.""" mock_export.side_effect = TypeError("Cannot serialize object") - result = await export_json_handler({"data": "test"}, True) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "export_json" - assert result["_meta"]["error"] == "TypeError" + with pytest.raises(ToolError, match="export_json failed"): + await export_json_handler({"data": "test"}, True) @pytest.mark.asyncio - @patch("mcp_handlers.export_to_csv") + @patch("parallel_sort_mcp.mcp_handlers.export_to_csv") async def test_export_csv_handler_exception_path(self, mock_export): """Test export_csv_handler exception handling.""" mock_export.side_effect = ValueError("Invalid CSV format") - result = await export_csv_handler({"data": "test"}, True) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "export_csv" - assert result["_meta"]["error"] == "ValueError" + with pytest.raises(ToolError, match="export_csv failed"): + await export_csv_handler({"data": "test"}, True) @pytest.mark.asyncio - @patch("mcp_handlers.export_to_text") + @patch("parallel_sort_mcp.mcp_handlers.export_to_text") async def test_export_text_handler_exception_path(self, mock_export): """Test export_text_handler exception handling.""" mock_export.side_effect = UnicodeEncodeError("utf-8", "", 0, 1, "Cannot encode") - result = await export_text_handler({"data": "test"}, True) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "export_text" - assert result["_meta"]["error"] == "UnicodeEncodeError" + with pytest.raises(ToolError, match="export_text failed"): + await export_text_handler({"data": "test"}, True) @pytest.mark.asyncio - @patch("mcp_handlers.export_summary_report") + @patch("parallel_sort_mcp.mcp_handlers.export_summary_report") async def test_summary_report_handler_exception_path(self, mock_export): """Test summary_report_handler exception handling.""" mock_export.side_effect = RuntimeError("Report generation failed") - result = await summary_report_handler({"data": "test"}) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["tool"] == "summary_report" - assert result["_meta"]["error"] == "RuntimeError" + with pytest.raises(ToolError, match="summary_report failed"): + await summary_report_handler({"data": "test"}) @pytest.mark.asyncio - @patch("mcp_handlers.sort_log_by_timestamp") + @patch("parallel_sort_mcp.mcp_handlers.sort_log_by_timestamp") async def test_sort_log_handler_generic_exception(self, mock_sort): """Test sort_log_handler with generic Exception.""" mock_sort.side_effect = Exception("Generic error") - result = await sort_log_handler("test.log") - - assert "content" in result - assert result["isError"] is True - assert "error" in result["content"][0]["text"] + with pytest.raises(ToolError, match="sort_log failed"): + await sort_log_handler("test.log") @pytest.mark.asyncio - @patch("mcp_handlers.parallel_sort_large_file") + @patch("parallel_sort_mcp.mcp_handlers.parallel_sort_large_file") async def test_parallel_sort_handler_memory_error(self, mock_sort): """Test parallel_sort_handler with MemoryError.""" mock_sort.side_effect = MemoryError("Out of memory") - result = await parallel_sort_handler("test.log", 100, 4) - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["error"] == "MemoryError" + with pytest.raises(ToolError, match="parallel_sort failed"): + await parallel_sort_handler("test.log", 100, 4) @pytest.mark.asyncio - @patch("mcp_handlers.filter_logs") + @patch("parallel_sort_mcp.mcp_handlers.filter_logs") async def test_filter_logs_handler_permission_error(self, mock_filter): """Test filter_logs_handler with PermissionError.""" mock_filter.side_effect = PermissionError("Access denied") - result = await filter_logs_handler("test.log", [], "and") - - assert "content" in result - assert result["isError"] is True - assert result["_meta"]["error"] == "PermissionError" + with pytest.raises(ToolError, match="filter_logs failed"): + await filter_logs_handler("test.log", [], "and") diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_parallel_processor.py b/clio-kit-mcp-servers/parallel-sort/tests/test_parallel_processor.py index 3b013ca8..282d4dd6 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_parallel_processor.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_parallel_processor.py @@ -6,7 +6,7 @@ import tempfile import os from unittest.mock import patch -from implementation.parallel_processor import ( +from parallel_sort_mcp.implementation.parallel_processor import ( parallel_sort_large_file, split_file_into_chunks, process_single_chunk, diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_pattern_detection.py b/clio-kit-mcp-servers/parallel-sort/tests/test_pattern_detection.py index 7a02a20a..150508c7 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_pattern_detection.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_pattern_detection.py @@ -5,7 +5,7 @@ import pytest import tempfile import os -from implementation.pattern_detection import ( +from parallel_sort_mcp.implementation.pattern_detection import ( detect_patterns, normalize_message_for_pattern, ) diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_server.py b/clio-kit-mcp-servers/parallel-sort/tests/test_server.py index 86f75a81..44f3c9bd 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_server.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_server.py @@ -2,14 +2,9 @@ Tests for the Parallel Sort MCP server. """ -import os -import sys import pytest -# Add the src directory to the path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from server import mcp +from parallel_sort_mcp.server import mcp class TestServer: @@ -25,14 +20,19 @@ def sample_log_content(self): def test_server_initialization(self): """Test that the server initializes correctly.""" assert mcp is not None - assert mcp.name == "ParallelSortMCP" + assert mcp.name == "parallel-sort" def test_sort_tool_registration(self): """Test that the sort tool is properly registered.""" - # FastMCP may not expose tools directly, just verify server is functional - assert mcp.name == "ParallelSortMCP" + assert mcp.name == "parallel-sort" def test_sort_tool_metadata(self): """Test the sort tool is accessible through MCP server.""" - # Just verify the server was created successfully - assert mcp.name == "ParallelSortMCP" + assert mcp.name == "parallel-sort" + + def test_server_has_instructions(self): + """Test that the server has instructions configured.""" + assert mcp.instructions is not None + assert ( + "parallel" in mcp.instructions.lower() or "sort" in mcp.instructions.lower() + ) diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_server_main.py b/clio-kit-mcp-servers/parallel-sort/tests/test_server_main.py index d320d336..8b064517 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_server_main.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_server_main.py @@ -3,29 +3,24 @@ """ import os -import sys from unittest.mock import patch, MagicMock -# Add the src directory to the path for testing -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server +import parallel_sort_mcp.server as server class TestServerMain: """Test suite for server main function and initialization.""" @patch.dict(os.environ, {"MCP_TRANSPORT": "stdio"}, clear=False) - @patch("server.mcp") + @patch("parallel_sort_mcp.server.mcp") def test_main_stdio_transport(self, mock_mcp): """Test main function with stdio transport.""" mock_mcp.run = MagicMock() - # Mock sys.exit to prevent actual exit - with patch("sys.exit"): + with patch("sys.argv", ["parallel-sort-mcp"]): try: server.main() - except Exception: + except SystemExit: pass # Verify mcp.run was called with stdio @@ -34,42 +29,28 @@ def test_main_stdio_transport(self, mock_mcp): if call_args and call_args[1]: assert call_args[1].get("transport") == "stdio" - @patch.dict( - os.environ, - {"MCP_TRANSPORT": "sse", "MCP_SSE_HOST": "127.0.0.1", "MCP_SSE_PORT": "9000"}, - clear=False, - ) - @patch("server.mcp") - def test_main_sse_transport(self, mock_mcp): - """Test main function with SSE transport.""" + @patch.dict(os.environ, {"MCP_TRANSPORT": "http"}, clear=False) + @patch("parallel_sort_mcp.server.mcp") + def test_main_http_transport(self, mock_mcp): + """Test main function with HTTP transport.""" mock_mcp.run = MagicMock() - with patch("sys.exit"): + with patch("sys.argv", ["parallel-sort-mcp"]): try: server.main() - except Exception: + except SystemExit: pass - # Verify mcp.run was called with SSE parameters + # Verify mcp.run was called with HTTP parameters if mock_mcp.run.called: call_args = mock_mcp.run.call_args if call_args and call_args[1]: - assert call_args[1].get("transport") == "sse" - assert call_args[1].get("host") == "127.0.0.1" - assert call_args[1].get("port") == 9000 - - @patch("server.mcp") - def test_main_exception_handling(self, mock_mcp): - """Test main function exception handling.""" - mock_mcp.run = MagicMock(side_effect=Exception("Test error")) - - with patch("sys.exit") as mock_exit: - server.main() - # Verify sys.exit was called with error code - mock_exit.assert_called_once_with(1) + assert call_args[1].get("transport") == "http" + assert call_args[1].get("host") == "0.0.0.0" + assert call_args[1].get("port") == 8000 @patch.dict(os.environ, {}, clear=False) - @patch("server.mcp") + @patch("parallel_sort_mcp.server.mcp") def test_main_default_transport(self, mock_mcp): """Test main function with default transport (no env var).""" mock_mcp.run = MagicMock() @@ -78,10 +59,10 @@ def test_main_default_transport(self, mock_mcp): if "MCP_TRANSPORT" in os.environ: del os.environ["MCP_TRANSPORT"] - with patch("sys.exit"): + with patch("sys.argv", ["parallel-sort-mcp"]): try: server.main() - except Exception: + except SystemExit: pass # Default should be stdio @@ -90,28 +71,34 @@ def test_main_default_transport(self, mock_mcp): if call_args and call_args[1]: assert call_args[1].get("transport") == "stdio" - @patch.dict(os.environ, {"MCP_TRANSPORT": "sse"}, clear=False) - @patch("server.mcp") - def test_main_sse_default_host_port(self, mock_mcp): - """Test main function with SSE using default host and port.""" + @patch("parallel_sort_mcp.server.mcp") + def test_main_with_transport_arg(self, mock_mcp): + """Test main function with --transport argument.""" mock_mcp.run = MagicMock() - # Remove host/port env vars if they exist - os.environ.pop("MCP_SSE_HOST", None) - os.environ.pop("MCP_SSE_PORT", None) - - with patch("sys.exit"): + with patch( + "sys.argv", + [ + "parallel-sort-mcp", + "--transport", + "http", + "--host", + "127.0.0.1", + "--port", + "9000", + ], + ): try: server.main() - except Exception: + except SystemExit: pass - # Verify default host/port were used if mock_mcp.run.called: call_args = mock_mcp.run.call_args if call_args and call_args[1]: - assert call_args[1].get("host") == "0.0.0.0" - assert call_args[1].get("port") == 8000 + assert call_args[1].get("transport") == "http" + assert call_args[1].get("host") == "127.0.0.1" + assert call_args[1].get("port") == 9000 class TestServerImports: @@ -125,9 +112,9 @@ def test_server_module_attributes(self): def test_mcp_server_name(self): """Test MCP server has correct name.""" - assert server.mcp.name == "ParallelSortMCP" + assert server.mcp.name == "parallel-sort" def test_logger_configuration(self): """Test logger is configured.""" assert server.logger is not None - assert server.logger.name == "server" + assert server.logger.name == "parallel_sort_mcp.server" diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_sort_handler.py b/clio-kit-mcp-servers/parallel-sort/tests/test_sort_handler.py index 8eab344c..c286dd3c 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_sort_handler.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_sort_handler.py @@ -5,7 +5,10 @@ import pytest import tempfile import os -from implementation.sort_handler import sort_log_by_timestamp, parse_timestamp +from parallel_sort_mcp.implementation.sort_handler import ( + sort_log_by_timestamp, + parse_timestamp, +) from datetime import datetime @@ -167,6 +170,9 @@ async def test_sort_with_same_timestamps(self): os.unlink(temp_path) @pytest.mark.asyncio + @pytest.mark.skipif( + os.name == "nt", reason="os.chmod cannot remove read on Windows" + ) async def test_sort_permission_denied(self): """Test handling of permission denied errors.""" # Create a temporary file diff --git a/clio-kit-mcp-servers/parallel-sort/tests/test_statistics_handler.py b/clio-kit-mcp-servers/parallel-sort/tests/test_statistics_handler.py index c5467e43..1e9d1e81 100644 --- a/clio-kit-mcp-servers/parallel-sort/tests/test_statistics_handler.py +++ b/clio-kit-mcp-servers/parallel-sort/tests/test_statistics_handler.py @@ -5,7 +5,10 @@ import pytest import tempfile import os -from implementation.statistics_handler import analyze_log_statistics, parse_log_entry +from parallel_sort_mcp.implementation.statistics_handler import ( + analyze_log_statistics, + parse_log_entry, +) class TestStatisticsHandler: diff --git a/clio-kit-mcp-servers/parallel-sort/uv.lock b/clio-kit-mcp-servers/parallel-sort/uv.lock index ff8f096d..58a5cb07 100644 --- a/clio-kit-mcp-servers/parallel-sort/uv.lock +++ b/clio-kit-mcp-servers/parallel-sort/uv.lock @@ -417,18 +417,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.2" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/cc/2e/8c45ef5b00bd48d7cabbf6f90b7f12df4c232755cd46e6dbc6690f9ac0c5/cyclopts-3.22.2.tar.gz", hash = "sha256:d3495231af6ae86479579777d212ddf77b113200f828badeaf401162ed87227d", size = 74520, upload-time = "2025-07-09T12:21:46.866Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/5b/5939e05d87def1612c494429bee705d6b852fad1d21dd2dee1e3ce39997e/cyclopts-3.22.2-py3-none-any.whl", hash = "sha256:6681b0815fa2de2bccc364468fd25b15aa9617cb505c0b16ca62e2b18a57619e", size = 84578, upload-time = "2025-07-09T12:21:44.878Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -494,27 +495,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -577,7 +584,7 @@ name = "importlib-metadata" version = "8.7.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "zipp", marker = "python_full_version < '3.12'" }, + { name = "zipp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/76/66/650a33bd90f786193e4de4b3ad86ea60b53c89b669a5c7be931fac31cdb0/importlib_metadata-8.7.0.tar.gz", hash = "sha256:d13b81ad223b890aa16c5471f2ac3056cf76c5f10f82d6f9292f0b415f389000", size = 56641, upload-time = "2025-04-27T15:29:01.736Z" } wheels = [ @@ -638,6 +645,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.24.0" @@ -712,7 +728,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -726,11 +742,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -890,6 +908,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -970,7 +1001,7 @@ dev = [ [package.metadata] requires-dist = [ { name = "aiofiles", specifier = ">=23.0.0" }, - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "pandas", specifier = ">=1.5.0" }, { name = "python-dotenv", specifier = ">=1.0.0" }, ] @@ -1021,15 +1052,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1044,19 +1075,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -1756,6 +1774,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d2/e2/dc81b1bd1dcfe91735810265e9d26bc8ec5da45b4c0f6237e286819194c3/uvicorn-0.35.0-py3-none-any.whl", hash = "sha256:197535216b25ff9b785e29a0b79199f55222193d47f820816e7da751e9bc8d4a", size = 66406, upload-time = "2025-06-28T16:15:44.816Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/paraview/.claude-plugin/plugin.json b/clio-kit-mcp-servers/paraview/.claude-plugin/plugin.json new file mode 100644 index 00000000..c28e0fc5 --- /dev/null +++ b/clio-kit-mcp-servers/paraview/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-paraview", + "description": "MCP server for ParaView scientific visualization", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/paraview/.mcp.json b/clio-kit-mcp-servers/paraview/.mcp.json new file mode 100644 index 00000000..55dd5928 --- /dev/null +++ b/clio-kit-mcp-servers/paraview/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-paraview": { + "command": "uvx", + "args": [ + "clio-kit", + "paraview" + ] + } +} diff --git a/clio-kit-mcp-servers/paraview/README.md b/clio-kit-mcp-servers/paraview/README.md index 30bdb027..a5d1c9b3 100644 --- a/clio-kit-mcp-servers/paraview/README.md +++ b/clio-kit-mcp-servers/paraview/README.md @@ -188,47 +188,317 @@ $PARAVIEW_GUI ## Capabilities -### Data I/O (5 tools) -- **`load_scientific_data`** - Load VTK, EXODUS, CSV, RAW, BP5/ADIOS2, and other scientific data formats -- **`export_data`** - Export data to VTK, CSV, or other supported formats -- **`get_data_info`** - Get detailed information about loaded datasets -- **`list_arrays`** - List all available data arrays in the current dataset -- **`get_array_range`** - Get value range for a specific data array - -### Visualization & Filtering (10 tools) -- **`generate_isosurface`** - Create isosurface visualizations for extracting surfaces of constant value -- **`create_data_slice`** - Create slices through volume data to examine cross-sections -- **`configure_volume_display`** - Toggle volume rendering for direct 3D visualization -- **`generate_flow_streamlines`** - Create streamlines from vector field data for flow visualization -- **`apply_threshold_filter`** - Apply threshold filter to extract data within value range -- **`apply_clip_filter`** - Clip data using planes or other geometric shapes -- **`apply_calculator`** - Create derived fields using mathematical expressions -- **`apply_contour`** - Create contours at specific data values -- **`apply_warp_by_vector`** - Warp geometry using vector field -- **`toggle_object_visibility`** - Show or hide visualization objects in the pipeline - -### Rendering & Display (8 tools) -- **`apply_field_coloring`** - Color visualizations by specific data fields -- **`set_color_map`** - Set color map (lookup table) for data visualization -- **`set_color_map_preset`** - Apply preset color maps (Rainbow, Blue to Red, Viridis, etc.) -- **`get_histogram`** - Get histogram data for field values with automatic binning -- **`adjust_volume_opacity`** - Edit volume rendering opacity transfer function -- **`take_viewport_screenshot`** - Capture high-resolution screenshots of current ParaView viewport -- **`set_background_color`** - Set viewport background color -- **`set_representation`** - Change visualization representation (Surface, Wireframe, Points, etc.) - -### Camera & View Control (4 tools) -- **`rotate_camera`** - Rotate camera around center of rotation -- **`reset_camera`** - Reset camera to optimal viewing parameters -- **`set_camera_position`** - Set specific camera position and focal point -- **`adjust_camera_zoom`** - Adjust camera zoom level - -### ADIOS2/BP5 Support (2 tools) -- **`query_adios2_metadata`** - Query metadata from ADIOS2/BP5 files -- **`convert_bp5_to_vtk`** - Convert BP5/ADIOS2 files to VTK format - -**Total: 29 MCP Tools** providing comprehensive ParaView automation through natural language +### `load_scientific_data` +**Description**: Load scientific datasets (VTK, EXODUS, CSV, RAW, BP5) into ParaView with automatic format detection. +**Tags**: paraview, visualization +### `save_contour_as_stl` +**Description**: Save the active contour or surface as an STL file in the data directory. + +Args: + stl_filename: The STL file name to use, defaults to 'contour.stl'. + +Returns: + Status message. +**Tags**: paraview, pipeline + +### `create_geometric_shape` +**Description**: Create a geometric source (Sphere, Cone, Cylinder, Plane, or Box). + +Args: + source_type: Type of source to create. + +Returns: + Status message with source name. +**Tags**: paraview, pipeline + +### `generate_isosurface` +**Description**: Create an isosurface visualization of the active source at the given isovalue. + +Args: + value: Isovalue. + field: Optional field name to contour by. + +Returns: + Status message with filter name. +**Tags**: paraview, pipeline + +### `create_data_slice` +**Description**: Create a slice plane through the loaded volume data. + +Args: + origin_x, origin_y, origin_z: Slice origin coordinates (defaults to data center). + normal_x, normal_y, normal_z: Normal vector for the slice plane (default [0, 0, 1]). + +Returns: + Status message with pipeline name. +**Tags**: paraview, pipeline + +### `configure_volume_display` +**Description**: Toggle volume rendering visibility for the active source. + +Args: + enable: Whether to show (True) or hide (False) volume rendering. + +Returns: + Status message with source name. +**Tags**: paraview, rendering + +### `toggle_visibility` +**Description**: Toggle visibility for the active source. + +Args: + enable: Whether to show (True) or hide (False) the active source. + +Returns: + Status message with source name. +**Tags**: paraview, rendering + +### `set_active_source` +**Description**: Set the active pipeline object by its registered name. + +Args: + name: The pipeline source name (e.g., 'Contour1'). + +Returns: + Status message. +**Tags**: paraview, pipeline + +### `get_active_source_names_by_type` +**Description**: List pipeline source names, optionally filtered by type. + +Args: + source_type: Filter by type (e.g., 'Sphere', 'Contour'). None returns all. + +Returns: + Formatted list of source names. +**Hints**: read-only, idempotent +**Tags**: paraview, pipeline + +### `edit_volume_opacity` +**Description**: Edit the opacity transfer function for a scalar field. + +Args: + field_name: The scalar field to modify. + opacity_points: List of dicts like [{"value": 0.0, "alpha": 0.0}, ...]. + +Returns: + Status message. +**Tags**: paraview, rendering + +### `set_color_map` +**Description**: Set a custom color transfer function for volume rendering. + +Args: + field_name: The field/array name in ParaView. + color_points: List of dicts: {"value": float, "rgb": [r, g, b]}. + +Returns: + Status message. +**Tags**: paraview, rendering + +### `apply_field_coloring` +**Description**: Color the active visualization by a specific data field. + +Args: + field: Field name to color by. + component: Component index (-1 for magnitude). + +Returns: + Status message. +**Tags**: paraview, rendering + +### `compute_surface_area` +**Description**: Compute the surface area of the active dataset (must be a surface mesh). + +Returns: + Status message with area value. +**Hints**: read-only, idempotent +**Tags**: paraview, visualization + +### `set_color_map_preset` +**Description**: Apply a predefined color map preset (e.g., Viridis, Plasma, Cool to Warm). + +Args: + preset_name: Name of the color map preset. + +Returns: + Status message. +**Tags**: paraview, rendering + +### `set_representation_type` +**Description**: Set the representation type for the active source (Surface, Wireframe, Points, etc.). + +Args: + rep_type: Representation type. + +Returns: + Status message. +**Tags**: paraview, rendering + +### `get_pipeline` +**Description**: Get the current visualization pipeline structure. + +Returns: + Description of the current pipeline. +**Hints**: read-only, idempotent +**Tags**: paraview, pipeline + +### `get_available_arrays` +**Description**: List available data arrays in the active source. + +Returns: + List of available arrays. +**Hints**: read-only, idempotent +**Tags**: paraview, visualization + +### `get_histogram` +**Description**: Compute histogram data for a field in the active source. + +Args: + field: Field name (auto-selected if only one exists). + num_bins: Number of bins (default: 256). + data_location: 'POINTS' or 'CELLS'. + +Returns: + Formatted histogram data. +**Hints**: read-only, idempotent +**Tags**: paraview, visualization + +### `generate_flow_streamlines` +**Description**: Create streamlines from a vector volume using the StreamTracer filter. + +Args: + seed_point_number: Number of seed points to generate. + vector_field: Vector field name (auto-detected if None). + integration_direction: 'FORWARD', 'BACKWARD', or 'BOTH'. + max_steps: Maximum integration steps. + initial_step: Initial step length. + maximum_step: Maximum streamline length. + +Returns: + Status message with tube name. +**Tags**: paraview, pipeline + +### `take_viewport_screenshot` +**Description**: Capture a screenshot of the current ParaView viewport and save it as a timestamped PNG. +**Hints**: read-only, idempotent +**Tags**: paraview, rendering + +### `show_screenshot_preview` +**Description**: Capture a screenshot with inline preview using temporary files. +**Hints**: read-only, idempotent +**Tags**: paraview, rendering + +### `rotate_camera` +**Description**: Rotate the camera by azimuth and elevation angles in degrees. + +Args: + azimuth: Rotation around vertical axis. + elevation: Rotation around horizontal axis. + +Returns: + Status message. +**Tags**: paraview, rendering + +### `reset_camera` +**Description**: Reset the camera to show all data in the viewport. + +Returns: + Status message. +**Hints**: idempotent +**Tags**: paraview, rendering + +### `plot_over_line` +**Description**: Create a 'Plot Over Line' filter to sample data between two points. + +Args: + point1: Start [x, y, z] coordinates (defaults to data bounds). + point2: End [x, y, z] coordinates (defaults to data bounds). + resolution: Number of sample points (default: 100). + +Returns: + Status message. +**Tags**: paraview, pipeline + +### `warp_by_vector` +**Description**: Apply a 'Warp By Vector' filter to the active source. + +Args: + vector_field: Vector field name (auto-detected if None). + scale_factor: Scale factor for the warp. + +Returns: + Status message. +**Tags**: paraview, pipeline + +### `list_commands` +**Description**: List all available commands in this ParaView MCP server. + +Returns: + List of available commands. +**Hints**: read-only, idempotent +**Tags**: paraview, visualization + +### Resources + +- `paraview://capabilities` - ParaView visualization capabilities and supported formats. + +### Prompts + +- **visualize_data**: Guided workflow for creating a ParaView visualization. +## Claude Code + +```bash +claude mcp add clio-paraview -- uvx clio-kit paraview +``` + +Or install via the CLIO Kit plugin marketplace: + +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-paraview@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-paraview": { + "command": "uvx", + "args": [ + "clio-kit", + "paraview" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-paraview": { + "command": "uvx", + "args": [ + "clio-kit", + "paraview" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### Basic Scientific Data Visualization diff --git a/clio-kit-mcp-servers/paraview/pyproject.toml b/clio-kit-mcp-servers/paraview/pyproject.toml index 0f8d7715..f751c180 100644 --- a/clio-kit-mcp-servers/paraview/pyproject.toml +++ b/clio-kit-mcp-servers/paraview/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["MCP", "ParaView", "visualization", "scientific", "3D"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "adios2>=2.9.0", "numpy>=2.0.0", "python-dotenv>=1.0.0", diff --git a/clio-kit-mcp-servers/paraview/server.json b/clio-kit-mcp-servers/paraview/server.json new file mode 100644 index 00000000..1c4ddf78 --- /dev/null +++ b/clio-kit-mcp-servers/paraview/server.json @@ -0,0 +1,139 @@ +{ + "name": "io.github.iowarp/paraview-mcp", + "description": "MCP server for ParaView scientific visualization", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "paraview" + ] + }, + "tools": [ + { + "name": "load_scientific_data", + "description": "Load scientific datasets (VTK, EXODUS, CSV, RAW, BP5) into ParaView with automatic format detection." + }, + { + "name": "save_contour_as_stl", + "description": "Save the active contour or surface as an STL file in the data directory.\n\nArgs:\n stl_filename: The STL file name to use, defaults to 'contour.stl'.\n\nReturns:\n Status message." + }, + { + "name": "create_geometric_shape", + "description": "Create a geometric source (Sphere, Cone, Cylinder, Plane, or Box).\n\nArgs:\n source_type: Type of source to create.\n\nReturns:\n Status message with source name." + }, + { + "name": "generate_isosurface", + "description": "Create an isosurface visualization of the active source at the given isovalue.\n\nArgs:\n value: Isovalue.\n field: Optional field name to contour by.\n\nReturns:\n Status message with filter name." + }, + { + "name": "create_data_slice", + "description": "Create a slice plane through the loaded volume data.\n\nArgs:\n origin_x, origin_y, origin_z: Slice origin coordinates (defaults to data center).\n normal_x, normal_y, normal_z: Normal vector for the slice plane (default [0, 0, 1]).\n\nReturns:\n Status message with pipeline name." + }, + { + "name": "configure_volume_display", + "description": "Toggle volume rendering visibility for the active source.\n\nArgs:\n enable: Whether to show (True) or hide (False) volume rendering.\n\nReturns:\n Status message with source name." + }, + { + "name": "toggle_visibility", + "description": "Toggle visibility for the active source.\n\nArgs:\n enable: Whether to show (True) or hide (False) the active source.\n\nReturns:\n Status message with source name." + }, + { + "name": "set_active_source", + "description": "Set the active pipeline object by its registered name.\n\nArgs:\n name: The pipeline source name (e.g., 'Contour1').\n\nReturns:\n Status message." + }, + { + "name": "get_active_source_names_by_type", + "description": "List pipeline source names, optionally filtered by type.\n\nArgs:\n source_type: Filter by type (e.g., 'Sphere', 'Contour'). None returns all.\n\nReturns:\n Formatted list of source names." + }, + { + "name": "edit_volume_opacity", + "description": "Edit the opacity transfer function for a scalar field.\n\nArgs:\n field_name: The scalar field to modify.\n opacity_points: List of dicts like [{\"value\": 0.0, \"alpha\": 0.0}, ...].\n\nReturns:\n Status message." + }, + { + "name": "set_color_map", + "description": "Set a custom color transfer function for volume rendering.\n\nArgs:\n field_name: The field/array name in ParaView.\n color_points: List of dicts: {\"value\": float, \"rgb\": [r, g, b]}.\n\nReturns:\n Status message." + }, + { + "name": "apply_field_coloring", + "description": "Color the active visualization by a specific data field.\n\nArgs:\n field: Field name to color by.\n component: Component index (-1 for magnitude).\n\nReturns:\n Status message." + }, + { + "name": "compute_surface_area", + "description": "Compute the surface area of the active dataset (must be a surface mesh).\n\nReturns:\n Status message with area value." + }, + { + "name": "set_color_map_preset", + "description": "Apply a predefined color map preset (e.g., Viridis, Plasma, Cool to Warm).\n\nArgs:\n preset_name: Name of the color map preset.\n\nReturns:\n Status message." + }, + { + "name": "set_representation_type", + "description": "Set the representation type for the active source (Surface, Wireframe, Points, etc.).\n\nArgs:\n rep_type: Representation type.\n\nReturns:\n Status message." + }, + { + "name": "get_pipeline", + "description": "Get the current visualization pipeline structure.\n\nReturns:\n Description of the current pipeline." + }, + { + "name": "get_available_arrays", + "description": "List available data arrays in the active source.\n\nReturns:\n List of available arrays." + }, + { + "name": "get_histogram", + "description": "Compute histogram data for a field in the active source.\n\nArgs:\n field: Field name (auto-selected if only one exists).\n num_bins: Number of bins (default: 256).\n data_location: 'POINTS' or 'CELLS'.\n\nReturns:\n Formatted histogram data." + }, + { + "name": "generate_flow_streamlines", + "description": "Create streamlines from a vector volume using the StreamTracer filter.\n\nArgs:\n seed_point_number: Number of seed points to generate.\n vector_field: Vector field name (auto-detected if None).\n integration_direction: 'FORWARD', 'BACKWARD', or 'BOTH'.\n max_steps: Maximum integration steps.\n initial_step: Initial step length.\n maximum_step: Maximum streamline length.\n\nReturns:\n Status message with tube name." + }, + { + "name": "take_viewport_screenshot", + "description": "Capture a screenshot of the current ParaView viewport and save it as a timestamped PNG." + }, + { + "name": "show_screenshot_preview", + "description": "Capture a screenshot with inline preview using temporary files." + }, + { + "name": "rotate_camera", + "description": "Rotate the camera by azimuth and elevation angles in degrees.\n\nArgs:\n azimuth: Rotation around vertical axis.\n elevation: Rotation around horizontal axis.\n\nReturns:\n Status message." + }, + { + "name": "reset_camera", + "description": "Reset the camera to show all data in the viewport.\n\nReturns:\n Status message." + }, + { + "name": "plot_over_line", + "description": "Create a 'Plot Over Line' filter to sample data between two points.\n\nArgs:\n point1: Start [x, y, z] coordinates (defaults to data bounds).\n point2: End [x, y, z] coordinates (defaults to data bounds).\n resolution: Number of sample points (default: 100).\n\nReturns:\n Status message." + }, + { + "name": "warp_by_vector", + "description": "Apply a 'Warp By Vector' filter to the active source.\n\nArgs:\n vector_field: Vector field name (auto-detected if None).\n scale_factor: Scale factor for the warp.\n\nReturns:\n Status message." + }, + { + "name": "list_commands", + "description": "List all available commands in this ParaView MCP server.\n\nReturns:\n List of available commands." + } + ], + "resources": [ + { + "uri": "paraview://capabilities", + "name": "paraview_capabilities", + "description": "ParaView visualization capabilities and supported formats." + } + ], + "prompts": [ + { + "name": "visualize_data", + "description": "Guided workflow for creating a ParaView visualization." + } + ], + "tags": [ + "scientific-visualization", + "paraview", + "3d-rendering", + "hpc" + ] +} diff --git a/clio-kit-mcp-servers/paraview/src/paraview_mcp/server.py b/clio-kit-mcp-servers/paraview/src/paraview_mcp/server.py index 8b4067f3..71c09fbd 100644 --- a/clio-kit-mcp-servers/paraview/src/paraview_mcp/server.py +++ b/clio-kit-mcp-servers/paraview/src/paraview_mcp/server.py @@ -15,17 +15,18 @@ import os import sys -import json import logging import argparse from typing import Optional, TYPE_CHECKING from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message from fastmcp.utilities.types import Image from dotenv import load_dotenv if TYPE_CHECKING: - from implementation.paraview_capabilities import VisualizationEngine + from .implementation.paraview_capabilities import VisualizationEngine # Load environment variables load_dotenv() @@ -36,9 +37,6 @@ ) logger = logging.getLogger(__name__) -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - # Default prompt that instructs Claude how to interact with ParaView default_prompt = """ When using ParaView through this interface, please follow these guidelines: @@ -52,7 +50,14 @@ """ # Initialize MCP server -mcp: FastMCP = FastMCP("ParaView") +mcp: FastMCP = FastMCP( + "paraview", + instructions=( + "Controls ParaView for scientific visualization. " + "Open data files, apply filters, create renderings, and manage visualization pipelines." + ), + list_page_size=10, +) # ParaView manager will be initialized when needed pv_manager: Optional["VisualizationEngine"] = None @@ -65,7 +70,7 @@ def get_pv_manager() -> "VisualizationEngine": global pv_manager, server_host, server_port if pv_manager is None: try: - from implementation.paraview_capabilities import VisualizationEngine + from .implementation.paraview_capabilities import VisualizationEngine pv_manager = VisualizationEngine(server_host, server_port) @@ -101,41 +106,22 @@ def get_pv_manager() -> "VisualizationEngine": @mcp.tool( name="load_scientific_data", - description="Load scientific datasets from various file formats into ParaView for visualization and analysis. Supports VTK, EXODUS, CSV, RAW, BP5, and other scientific data formats. This enhanced function provides comprehensive file format detection and automatic configuration for optimal data loading.", + description="Load scientific datasets (VTK, EXODUS, CSV, RAW, BP5) into ParaView with automatic format detection.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "visualization"}, ) async def read_datafile_tool(file_path: str) -> str: - """ - Read and load data from a file into ParaView with advanced format detection and error handling. - - This function provides robust data loading capabilities with: - - Automatic file format detection based on file extension - - Special handling for volume data formats (RAW, BP5/ADIOS2) - - Comprehensive error reporting and troubleshooting guidance - - Automatic camera positioning and display configuration + """Load a data file into ParaView for visualization and analysis. Args: - file_path (str): Absolute path to the data file. Supports multiple formats: - - VTK formats (.vtk, .vti, .vtr, .vts, .vtu, .vtp) - - EXODUS formats (.e, .exo, .exodus) - - CSV files (.csv) - - RAW volume files (.raw) - - ADIOS2/BP5 files (.bp, .bp5) - - Legacy formats and other scientific data formats + file_path: Absolute path to the data file. Returns: - str: Detailed status message including: - - Success/failure status - - Source registration name for pipeline operations - - Error details with troubleshooting guidance if loading fails - - File format detection information - - Raises: - FileNotFoundError: If the specified file path does not exist - UnsupportedFormatError: If the file format is not supported by ParaView - - Example: - >>> read_datafile("/path/to/volume_data.vti") - "Successfully loaded data from /path/to/volume_data.vti. Source registered as 'volume_data.vti'." + Status message with source registration name. """ logger.info(f"Reading datafile from {file_path}") @@ -143,7 +129,9 @@ async def read_datafile_tool(file_path: str) -> str: import os if not os.path.exists(file_path): - return f"Error: File not found at path '{file_path}'. Please verify the file path is correct and the file exists." + raise ToolError( + f"File not found at path '{file_path}'. Please verify the file path is correct and the file exists." + ) # Get file size for logging and diagnostics try: @@ -169,66 +157,94 @@ async def read_datafile_tool(file_path: str) -> str: elif file_ext in [".vtk", ".vti", ".vtr", ".vts", ".vtu", ".vtp"]: error_guidance = "\nFor VTK files: Check if the file is corrupted or uses an unsupported VTK version." - return f"{message}{error_guidance}" + raise ToolError(f"{message}{error_guidance}") -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def save_contour_as_stl(stl_filename: str = "contour.stl") -> str: - """ - Save the currently active contour (or any surface/mesh source) as an STL file - in the same folder as the originally loaded data. + """Save the active contour or surface as an STL file in the data directory. Args: stl_filename: The STL file name to use, defaults to 'contour.stl'. Returns: - A status message (string). + Status message. """ success, message, path = get_pv_manager().save_contour_as_stl(stl_filename) + if not success: + raise ToolError(message) return message -@mcp.tool(name="create_geometric_shape") +@mcp.tool( + name="create_geometric_shape", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def create_source(source_type: str) -> str: - """ - Create a new geometric source. + """Create a geometric source (Sphere, Cone, Cylinder, Plane, or Box). Args: - source_type: Type of source to create (Sphere, Cone, Cylinder, Plane, Box) + source_type: Type of source to create. Returns: - Status message + Status message with source name. """ success, message, _, source_name = get_pv_manager().create_source(source_type) if success: return f"{message}. Source registered as '{source_name}'." else: - return message + raise ToolError(message) -@mcp.tool(name="generate_isosurface") +@mcp.tool( + name="generate_isosurface", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def create_isosurface(value: float, field: Optional[str] = None) -> str: - """ - Create an isosurface visualization of the active source. + """Create an isosurface visualization of the active source at the given isovalue. Args: - value: Isovalue - field: Optional field name to contour by + value: Isovalue. + field: Optional field name to contour by. Returns: - Status message + Status message with filter name. """ success, message, contour_obj, contour_name = get_pv_manager().create_isosurface( value, field ) if success: - # Return a user-friendly message that also includes the name return f"{message}. Filter registered as '{contour_name}'." else: - return message + raise ToolError(message) -@mcp.tool(name="create_data_slice") +@mcp.tool( + name="create_data_slice", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def create_slice( origin_x: Optional[float] = None, origin_y: Optional[float] = None, @@ -237,94 +253,113 @@ def create_slice( normal_y: float = 0, normal_z: float = 1, ) -> str: - """ - Create a slice through the loaded volume data. + """Create a slice plane through the loaded volume data. Args: - origin_x, origin_y, origin_z: Coordinates for the slice plane's origin. If None, - defaults to the data set's center. + origin_x, origin_y, origin_z: Slice origin coordinates (defaults to data center). normal_x, normal_y, normal_z: Normal vector for the slice plane (default [0, 0, 1]). Returns: - A string message containing success/failure details, plus the pipeline name. + Status message with pipeline name. """ success, message, slice_filter, slice_name = get_pv_manager().create_slice( origin_x, origin_y, origin_z, normal_x, normal_y, normal_z ) - # Return either an error message or a success message including the slice's name - return message if success else f"Error creating slice: {message}" + if success: + return message + else: + raise ToolError(f"Error creating slice: {message}") -@mcp.tool(name="configure_volume_display") +@mcp.tool( + name="configure_volume_display", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def toggle_volume_rendering(enable: bool = True) -> str: - """ - Toggle the visibility of volume rendering for the active source. + """Toggle volume rendering visibility for the active source. Args: - enable (bool): Whether to show (True) or hide (False) volume rendering. - If True, shows volume rendering (switching to 'Volume' representation if needed). - If False, hides the volume but preserves the volume representation settings. + enable: Whether to show (True) or hide (False) volume rendering. Returns: - Status message + Status message with source name. """ - success, message, source_name = get_pv_manager().create_volume_rendering(enable) if success: - # Return a user-friendly message that also includes the name return f"{message}. Source registered as '{source_name}'." else: - return message + raise ToolError(message) -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def toggle_visibility(enable: bool = True) -> str: - """ - Toggle the visibility for the active source. + """Toggle visibility for the active source. Args: - enable (bool): Whether to show (True) or hide (False) the active source. - If True, makes the active source visible. - If False, hides the active source but preserves the representation settings. + enable: Whether to show (True) or hide (False) the active source. Returns: - Status message + Status message with source name. """ - success, message, source_name = get_pv_manager().toggle_visibility(enable) if success: - # Return a user-friendly message that also includes the name return f"{message}. Source registered as '{source_name}'." else: - return message + raise ToolError(message) -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def set_active_source(name: str) -> str: - """ - Set the active pipeline object by its name. + """Set the active pipeline object by its registered name. - Usage: - set_active_source("Contour1") + Args: + name: The pipeline source name (e.g., 'Contour1'). - Returns a status message. + Returns: + Status message. """ success, message = get_pv_manager().set_active_source(name) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "pipeline"}, +) def get_active_source_names_by_type(source_type: Optional[str] = None) -> str: - """ - Get a list of source names filtered by their type. + """List pipeline source names, optionally filtered by type. Args: - source_type (str, optional): Filter sources by type (e.g., 'Sphere', 'Contour', etc.). - If None, returns all sources. + source_type: Filter by type (e.g., 'Sphere', 'Contour'). None returns all. Returns: - A string message containing the source names or error message. + Formatted list of source names. """ success, message, source_names = get_pv_manager().get_active_source_names_by_type( source_type @@ -334,6 +369,8 @@ def get_active_source_names_by_type(source_type: Optional[str] = None) -> str: sources_list = "\n- ".join(source_names) result = f"{message}:\n- {sources_list}" return result + elif not success: + raise ToolError(message) else: return message @@ -358,24 +395,30 @@ def get_active_source_names_by_type(source_type: Optional[str] = None) -> str: # return message -# Compatible with OpenAI tool using -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def edit_volume_opacity(field_name: str, opacity_points: list[dict[str, float]]) -> str: - """ - Edit ONLY the opacity transfer function for the specified field. + """Edit the opacity transfer function for a scalar field. Args: - field_name (str): The scalar field to modify. - opacity_points (list): A list of dicts like: - [{"value": 0.0, "alpha": 0.0}, {"value": 50.0, "alpha": 0.3}] + field_name: The scalar field to modify. + opacity_points: List of dicts like [{"value": 0.0, "alpha": 0.0}, ...]. Returns: - A status message (success or error) + Status message. """ formatted_points = [[pt["value"], pt["alpha"]] for pt in opacity_points] success, message = get_pv_manager().edit_volume_opacity( field_name, formatted_points ) + if not success: + raise ToolError(message) return message @@ -399,163 +442,186 @@ def edit_volume_opacity(field_name: str, opacity_points: list[dict[str, float]]) # return message -# Compatible with OpenAI tool using -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def set_color_map(field_name: str, color_points: list[dict]) -> str: - """ - Sets the color transfer function for the specified field. - - [Tips: only volume rendering should be using the set_color_map function, the lower values range corresponds to lower density objects, whereas higher values indicate high physical density. When design the color mapping try to assess the object of interest's density first from the default colormap (low value assigned to blue, high value assigned to red) and re-assign customized color accordingly, the order of the color may need to be adjust based on the rendering result. The more solid object should have higher density (!high value range). And a screen_shot should always be taken once this function is called to assess how to adjust the color_map again.] + """Set a custom color transfer function for volume rendering. Args: - field_name (str): The name of the field/array (as it appears in ParaView). - color_points (list of dicts): Each element should be a dict: - {"value": float, "rgb": [r, g, b]} where r,g,b ∈ [0,1]. - - Example: - [ - {"value": 0.0, "rgb": [0.0, 0.0, 1.0]}, - {"value": 50.0, "rgb": [0.0, 1.0, 0.0]}, - {"value": 100.0, "rgb": [1.0, 0.0, 0.0]} - ] + field_name: The field/array name in ParaView. + color_points: List of dicts: {"value": float, "rgb": [r, g, b]}. Returns: - A status message (success or error). + Status message. """ - # Transform color_points to expected internal format: list[tuple[float, tuple[float, float, float]]] try: formatted_points = [(pt["value"], tuple(pt["rgb"])) for pt in color_points] except Exception as e: - return f"Invalid format for color_points: {e}" + raise ToolError(f"Invalid format for color_points: {e}") success, message = get_pv_manager().set_color_map(field_name, formatted_points) + if not success: + raise ToolError(message) return message -@mcp.tool(name="apply_field_coloring") +@mcp.tool( + name="apply_field_coloring", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def color_by(field: str, component: int = -1) -> str: - """ - Color the active visualization by a specific field. - This function first checks if the active source can be colored by fields - (i.e., it's a dataset with arrays) before attempting to apply colors. - [tips] Volume rendering should not use this function + """Color the active visualization by a specific data field. Args: - field: Field name to color by - component: Component to color by (-1 for magnitude) + field: Field name to color by. + component: Component index (-1 for magnitude). Returns: - Status message + Status message. """ success, message = get_pv_manager().color_by(field, component) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "visualization"}, +) def compute_surface_area() -> str: - """ - Compute the surface area of the currently active dataset. - NOTE: Must be a surface mesh or 'Area' array won't exist. + """Compute the surface area of the active dataset (must be a surface mesh). + + Returns: + Status message with area value. """ success, message, area_value = get_pv_manager().compute_surface_area() + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def set_color_map_preset(preset_name: str = "Cool to Warm") -> str: - """ - Set the color map (lookup table) for the current visualization using a preset. - - This applies a predefined color scheme to the active source. Common presets include - scientific visualization standards optimized for different data types. - - [Tips: Use this for quick color scheme application. For volume rendering, call this - before fine-tuning with set_color_map if needed.] + """Apply a predefined color map preset (e.g., Viridis, Plasma, Cool to Warm). Args: - preset_name (str): Name of the color map preset. Common options include: - - "Cool to Warm" (default, diverging colormap) - - "Viridis" (perceptually uniform) - - "Plasma" (perceptually uniform) - - "Magma" (perceptually uniform) - - "Inferno" (perceptually uniform) - - "Rainbow" (classic rainbow) - - "Blue-Red" (diverging) - - "Grayscale" (monochrome) + preset_name: Name of the color map preset. Returns: - Status message indicating success or available presets + Status message. """ success, message = get_pv_manager().set_color_map_preset(preset_name) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def set_representation_type(rep_type: str) -> str: - """ - Set the representation type for the active source. - - [Tips: This function should not be used for volume rendering] + """Set the representation type for the active source (Surface, Wireframe, Points, etc.). Args: - rep_type: Representation type (Surface, Wireframe, Points, etc.) + rep_type: Representation type. Returns: - Status message + Status message. """ success, message = get_pv_manager().set_representation_type(rep_type) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "pipeline"}, +) def get_pipeline() -> str: - """ - Get the current pipeline structure. + """Get the current visualization pipeline structure. Returns: - Description of the current pipeline + Description of the current pipeline. """ success, message = get_pv_manager().get_pipeline() + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "visualization"}, +) def get_available_arrays() -> str: - """ - Get a list of available arrays in the active source. - - [tips: normally volume rendering would not require this information] + """List available data arrays in the active source. Returns: - List of available arrays + List of available arrays. """ success, message = get_pv_manager().get_available_arrays() + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "visualization"}, +) def get_histogram( field: Optional[str] = None, num_bins: int = 256, data_location: str = "POINTS" ) -> str: - """ - Compute and retrieve histogram data for a field in the active data source. - - This function is designed to work with volume sources. By default it uses the - point data arrays (data_location="POINTS"), but you can specify "CELLS" if your - volume source stores scalars on cells. - - If no field is provided and the active source contains exactly one available numeric - field in the specified data location, that field is automatically used. If multiple - arrays exist, you must specify which field to use. + """Compute histogram data for a field in the active source. Args: - field (str, optional): The name of the field for which the histogram is computed. - If None and only one field exists, it will be auto-selected. - num_bins (int): Number of histogram bins (default: 256). - data_location (str): Specify "POINTS" (default) or "CELLS" to indicate the source of the data. + field: Field name (auto-selected if only one exists). + num_bins: Number of bins (default: 256). + data_location: 'POINTS' or 'CELLS'. Returns: - Status message with histogram data or error information + Formatted histogram data. """ success, message, histogram_data = get_pv_manager().get_histogram( field, num_bins, data_location @@ -584,10 +650,18 @@ def get_histogram( return hist_summary else: - return message + raise ToolError(message) -@mcp.tool(name="generate_flow_streamlines") +@mcp.tool( + name="generate_flow_streamlines", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def create_streamline( seed_point_number: int, vector_field: Optional[str] = None, @@ -596,27 +670,23 @@ def create_streamline( initial_step: float = 0.1, maximum_step: float = 50.0, ) -> str: - """ - Create streamlines from the loaded vector volume using the StreamTracer filter. - This function automatically generates seed points based on the data bounds. + """Create streamlines from a vector volume using the StreamTracer filter. Args: - seed_point_number (int): The number of seed points to automatically generate. - vector_field (str, optional): The name of the vector field to use for tracing. - If None, the first vector field will be chosen automatically. - integration_direction (str): Integration direction ("FORWARD", "BACKWARD", or "BOTH"; default: "BOTH"). - max_steps (int): Maximum number of integration steps (default: 1000). - initial_step (float): Initial integration step length (default: 0.1). - maximum_step (float): Maximum streamline length (default: 50.0). + seed_point_number: Number of seed points to generate. + vector_field: Vector field name (auto-detected if None). + integration_direction: 'FORWARD', 'BACKWARD', or 'BOTH'. + max_steps: Maximum integration steps. + initial_step: Initial step length. + maximum_step: Maximum streamline length. Returns: - str: Status message indicating whether the streamline was successfully created. + Status message with tube name. """ - # Call the stream tracer creation method in your ParaViewManager success, message, streamline, tube_name = get_pv_manager().create_stream_tracer( vector_field=vector_field, - base_source=None, # Use the active source - point_center=None, # Auto-calculate the center + base_source=None, + point_center=None, integration_direction=integration_direction, initial_step_length=initial_step, maximum_stream_length=maximum_step, @@ -626,26 +696,29 @@ def create_streamline( if success: return f"{message} Tube registered as '{tube_name}'." else: - return message + raise ToolError(message) @mcp.tool( name="take_viewport_screenshot", - description="Capture a screenshot of the current ParaView viewport and save it to the current working directory. The screenshot will be displayed in chat and saved as a timestamped PNG file for reference.", + description="Capture a screenshot of the current ParaView viewport and save it as a timestamped PNG.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "rendering"}, ) async def get_screenshot_tool() -> str: - """ - Capture a screenshot of the current view and save it to the current working directory. - This avoids preview window issues by saving the file directly. + """Capture a screenshot of the current viewport and save to the working directory. Returns: - Image data and file path information + File path information. """ import os logger.info("Capturing ParaView viewport screenshot") - # Get current working directory for user reference current_dir = os.getcwd() logger.info(f"Screenshot will be saved to: {current_dir}") @@ -653,24 +726,29 @@ async def get_screenshot_tool() -> str: if not success: logger.error(f"Screenshot capture failed: {message}") - return f"❌ Screenshot failed: {message}" + raise ToolError(f"Screenshot failed: {message}") else: - # Extract just the filename for display filename = os.path.basename(img_path) logger.info(f"Screenshot saved successfully: {filename}") - # Return text information only to avoid preview window issues - return f"✅ {message}\n📁 Saved in: {current_dir}\n📄 Filename: {filename}\n\nScreenshot captured and saved successfully! You can view the file directly from your file system." + return f"{message}\nSaved in: {current_dir}\nFilename: {filename}" @mcp.tool( name="show_screenshot_preview", - description="Capture screenshot with improved inline preview. Uses temporary files and cleanup to avoid window closing issues.", + description="Capture a screenshot with inline preview using temporary files.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "rendering"}, ) async def show_screenshot_preview() -> str: - """ - Screenshot tool with improved preview handling. - Creates a temporary copy that gets cleaned up to avoid file locking issues. + """Capture a screenshot with inline preview handling. + + Returns: + Screenshot preview with file path information. """ import os import shutil @@ -685,24 +763,19 @@ async def show_screenshot_preview() -> str: if not success: logger.error(f"Screenshot capture failed: {message}") - return f"❌ Screenshot failed: {message}" + raise ToolError(f"Screenshot failed: {message}") else: filename = os.path.basename(img_path) logger.info(f"Screenshot saved: {filename}") - # Create a temporary copy for preview that gets cleaned up quickly - # This might help with window closing issues temp_preview_path = None try: - # Create temp file for preview only with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as temp_file: temp_preview_path = temp_file.name - # Copy the screenshot to temp location for preview shutil.copy2(img_path, temp_preview_path) - # Schedule immediate cleanup after a short delay (30 seconds) - def cleanup_preview(): + def cleanup_preview() -> None: time.sleep(30) try: if temp_preview_path and os.path.exists(temp_preview_path): @@ -713,46 +786,61 @@ def cleanup_preview(): except Exception as e: logger.warning(f"Failed to cleanup preview temp: {e}") - # Start cleanup thread threading.Thread(target=cleanup_preview, daemon=True).start() - # Return the image with metadata that should allow proper dismissal - result = f"📸 Screenshot Preview\n✅ Saved as: {filename}\n📁 Location: {current_dir}\n\n" + result = ( + f"Screenshot Preview\nSaved as: {filename}\nLocation: {current_dir}\n\n" + ) result += str(Image(path=temp_preview_path)) return result except Exception as e: logger.error(f"Failed to create preview: {e}") - # Fall back to text-only response - return f"✅ Screenshot saved: {filename}\n📁 Location: {current_dir}\n⚠️ Preview failed: {e}" + return f"Screenshot saved: {filename}\nLocation: {current_dir}\nPreview failed: {e}" -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "rendering"}, +) def rotate_camera(azimuth: float = 30.0, elevation: float = 0.0) -> str: - """ - Rotate the camera by specified angles. + """Rotate the camera by azimuth and elevation angles in degrees. Args: - azimuth: Rotation around vertical axis in degrees - elevation: Rotation around horizontal axis in degrees + azimuth: Rotation around vertical axis. + elevation: Rotation around horizontal axis. Returns: - Status message + Status message. """ success, message = get_pv_manager().rotate_camera(azimuth, elevation) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "rendering"}, +) def reset_camera() -> str: - """ - Reset the camera to show all data. + """Reset the camera to show all data in the viewport. Returns: - Status message + Status message. """ success, message = get_pv_manager().reset_camera() + if not success: + raise ToolError(message) return message @@ -773,57 +861,78 @@ def reset_camera() -> str: # return message -# Compatible with OpenAI tool using -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def plot_over_line( point1: Optional[list[float]] = None, point2: Optional[list[float]] = None, resolution: int = 100, ) -> str: - """ - Create a 'Plot Over Line' filter to sample data along a line between two points. + """Create a 'Plot Over Line' filter to sample data between two points. Args: - point1 (list of float): The [x, y, z] coordinates of the start point. If None, will use data bounds. - point2 (list of float): The [x, y, z] coordinates of the end point. If None, will use data bounds. - resolution (int): Number of sample points along the line (default: 100). + point1: Start [x, y, z] coordinates (defaults to data bounds). + point2: End [x, y, z] coordinates (defaults to data bounds). + resolution: Number of sample points (default: 100). Returns: - Status message + Status message. """ success, message, plot_filter = get_pv_manager().plot_over_line( point1, point2, resolution ) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"paraview", "pipeline"}, +) def warp_by_vector( vector_field: Optional[str] = None, scale_factor: float = 1.0 ) -> str: - """ - Apply the 'Warp By Vector' filter to the active source. + """Apply a 'Warp By Vector' filter to the active source. Args: - vector_field (str, optional): The name of the vector field to use for warping. If None, the first available vector field will be used. - scale_factor (float, optional): The scale factor for the warp (default: 1.0). + vector_field: Vector field name (auto-detected if None). + scale_factor: Scale factor for the warp. Returns: - Status message + Status message. """ success, message, warp_filter = get_pv_manager().warp_by_vector( vector_field, scale_factor ) + if not success: + raise ToolError(message) return message -@mcp.tool() +@mcp.tool( + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"paraview", "visualization"}, +) def list_commands() -> str: - """ - List all available commands in this ParaView MCP server. + """List all available commands in this ParaView MCP server. Returns: - List of available commands + List of available commands. """ commands = [ "load_scientific_data: Load scientific datasets from various file formats (VTK, EXODUS, CSV, RAW, BP5, etc.)", @@ -856,6 +965,27 @@ def list_commands() -> str: return "Available ParaView commands:\n\n" + "\n".join(commands) +@mcp.resource("paraview://capabilities") +def paraview_capabilities() -> dict: + """ParaView visualization capabilities and supported formats.""" + return { + "supported_formats": ["VTK", "VTU", "VTS", "PVD", "STL", "OBJ", "PLY"], + "operations": ["open", "filter", "render", "screenshot", "pipeline management"], + } + + +@mcp.prompt() +def visualize_data(file_path: str) -> list[Message]: + """Guided workflow for creating a ParaView visualization.""" + return [ + Message( + f"I need to visualize the data file at {file_path}. " + "Open it in ParaView, apply appropriate filters, create a rendering, " + "and save a screenshot." + ), + ] + + def main(): """ Main entry point for the ParaView MCP server. @@ -874,15 +1004,15 @@ def main(): ) parser.add_argument( "--transport", - choices=["stdio", "sse"], - default="stdio", + choices=["stdio", "http"], + default=None, help="Transport type to use (default: stdio)", ) parser.add_argument( - "--host", default="0.0.0.0", help="Host for SSE transport (default: 0.0.0.0)" + "--host", default="0.0.0.0", help="Host for HTTP transport (default: 0.0.0.0)" ) parser.add_argument( - "--port", type=int, default=8000, help="Port for SSE transport (default: 8000)" + "--port", type=int, default=8000, help="Port for HTTP transport (default: 8000)" ) parser.add_argument( "--server", @@ -920,28 +1050,15 @@ def main(): # Note: ParaView connection will be established when first tool is called - # Use command-line args or environment variables - transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio").lower() - - if transport == "sse": - # SSE transport for web-based clients - host = args.host or os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = args.port or int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + else: - # Default stdio transport - logger.info("Starting stdio transport") - print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") + mcp.run(transport=transport) except Exception as e: logger.error(f"Server error: {e}") - print(json.dumps({"error": str(e)}), file=sys.stderr) sys.exit(1) diff --git a/clio-kit-mcp-servers/paraview/tests/test_server.py b/clio-kit-mcp-servers/paraview/tests/test_server.py index 24d84a90..65284619 100644 --- a/clio-kit-mcp-servers/paraview/tests/test_server.py +++ b/clio-kit-mcp-servers/paraview/tests/test_server.py @@ -12,19 +12,23 @@ def test_server_import(): from paraview_mcp.server import mcp assert mcp is not None - assert mcp.name == "ParaView" + assert mcp.name == "paraview" except ImportError as e: pytest.skip(f"ParaView not available: {e}") def test_fastmcp_initialization(): - """Test FastMCP server initialization""" + """Test FastMCP server initialization with instructions""" try: from paraview_mcp.server import mcp # Check that the server is properly initialized assert hasattr(mcp, "name") - assert mcp.name == "ParaView" + assert mcp.name == "paraview" + + # Verify instructions are set + assert mcp.instructions is not None + assert "ParaView" in mcp.instructions except ImportError: pytest.skip("ParaView not available") @@ -45,20 +49,68 @@ def test_tools_registration(): try: from paraview_mcp.server import mcp - # Check that MCP server has tools registered - # FastMCP 2.0 stores tools differently - check for tool registry - assert hasattr(mcp, "_tool_registry") or hasattr(mcp, "tool"), ( - "MCP server should have tools registered" + # FastMCP 3.0 uses tool decorator - check the server has methods + assert callable(getattr(mcp, "tool", None)), ( + "MCP server should have tool method" ) - - # Since the actual tool registration happens at import time, - # we can check that the server has the expected functionality assert callable(getattr(mcp, "run", None)), "MCP server should have run method" except ImportError: pytest.skip("ParaView not available") +def test_tool_functions_are_callable(): + """Test that tool-decorated functions are callable (v3 returns original functions)""" + try: + from paraview_mcp.server import ( + create_source, + create_isosurface, + get_pipeline, + list_commands, + reset_camera, + ) + + # In FastMCP 3.0, decorated functions are the original functions + assert callable(create_source) + assert callable(create_isosurface) + assert callable(get_pipeline) + assert callable(list_commands) + assert callable(reset_camera) + except ImportError: + pytest.skip("ParaView not available") + + +def test_resource_registration(): + """Test that the paraview capabilities resource is registered""" + try: + from paraview_mcp.server import paraview_capabilities + + # In FastMCP 3.0, resource decorator returns the original function + assert callable(paraview_capabilities) + result = paraview_capabilities() + assert isinstance(result, dict) + assert "supported_formats" in result + assert "operations" in result + assert "VTK" in result["supported_formats"] + except ImportError: + pytest.skip("ParaView not available") + + +def test_prompt_registration(): + """Test that the visualize_data prompt is registered""" + try: + from paraview_mcp.server import visualize_data + + # In FastMCP 3.0, prompt decorator returns the original function + assert callable(visualize_data) + result = visualize_data("/test/file.vtk") + assert isinstance(result, list) + assert len(result) == 1 + assert "/test/file.vtk" in str(result[0]) + except ImportError: + pytest.skip("ParaView not available") + + def test_mock_paraview_manager(): """Test server functionality with mocked ParaView manager""" with patch("paraview_mcp.server.get_pv_manager") as mock_manager: @@ -86,5 +138,38 @@ def test_mock_paraview_manager(): pytest.skip("ParaView not available") +def test_tool_error_import(): + """Test that ToolError is properly imported from fastmcp""" + try: + from paraview_mcp.server import ToolError # noqa: F401 + from fastmcp.exceptions import ToolError as FastMCPToolError + + assert ToolError is FastMCPToolError + except ImportError: + pytest.skip("fastmcp not available") + + +def test_message_import(): + """Test that Message is properly imported from fastmcp.prompts""" + try: + from paraview_mcp.server import Message # noqa: F401 + from fastmcp.prompts import Message as FastMCPMessage + + assert Message is FastMCPMessage + except ImportError: + pytest.skip("fastmcp not available") + + +def test_transport_stdio_default(): + """Test that the default transport is stdio""" + try: + from paraview_mcp.server import main + + # The main function supports transport="stdio" by default + assert callable(main) + except ImportError: + pytest.skip("ParaView not available") + + if __name__ == "__main__": pytest.main([__file__]) diff --git a/clio-kit-mcp-servers/paraview/uv.lock b/clio-kit-mcp-servers/paraview/uv.lock index e020b118..efe6d039 100644 --- a/clio-kit-mcp-servers/paraview/uv.lock +++ b/clio-kit-mcp-servers/paraview/uv.lock @@ -1,5 +1,5 @@ version = 1 -revision = 3 +revision = 2 requires-python = ">=3.10" resolution-markers = [ "python_full_version >= '3.11'", @@ -541,27 +541,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -685,6 +691,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -759,7 +774,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -773,11 +788,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -1013,6 +1030,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/12/cf/03675d8bd8ecbf4445504d8071adab19f5f993676795708e36402ab38263/openapi_pydantic-0.5.1-py3-none-any.whl", hash = "sha256:a3a09ef4586f5bd760a8df7f43028b60cafb6d9f61de2acba9574766255ab146", size = 96381, upload-time = "2025-01-08T19:29:25.275Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -1046,7 +1076,7 @@ dev = [ [package.metadata] requires-dist = [ { name = "adios2", specifier = ">=2.9.0" }, - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "numpy", specifier = ">=2.0.0" }, { name = "python-dotenv", specifier = ">=1.0.0" }, ] @@ -1107,15 +1137,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1130,19 +1160,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.23" @@ -1826,6 +1843,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ee/d9/d88e73ca598f4f6ff671fb5fde8a32925c2e08a637303a1d12883c7305fa/uvicorn-0.38.0-py3-none-any.whl", hash = "sha256:48c0afd214ceb59340075b4a052ea1ee91c16fbc2a9b1469cca0e54566977b02", size = 68109, upload-time = "2025-10-18T13:46:42.958Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/parquet/.claude-plugin/plugin.json b/clio-kit-mcp-servers/parquet/.claude-plugin/plugin.json new file mode 100644 index 00000000..58b5372f --- /dev/null +++ b/clio-kit-mcp-servers/parquet/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-parquet", + "description": "MCP server for Apache Parquet files", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/parquet/.gitignore b/clio-kit-mcp-servers/parquet/.gitignore index ebeb6656..656c8150 100644 --- a/clio-kit-mcp-servers/parquet/.gitignore +++ b/clio-kit-mcp-servers/parquet/.gitignore @@ -6,7 +6,7 @@ FILTER_TEST_SUMMARY.md TEST_SUITE_COMPLETE.md TEST_SUITE_STATUS.md workflow_log.json -.mcp.json +# .mcp.json is now used for Claude Code plugin integration # Standard Python ignores __pycache__/ diff --git a/clio-kit-mcp-servers/parquet/.mcp.json b/clio-kit-mcp-servers/parquet/.mcp.json new file mode 100644 index 00000000..a8b1d080 --- /dev/null +++ b/clio-kit-mcp-servers/parquet/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-parquet": { + "command": "uvx", + "args": [ + "clio-kit", + "parquet" + ] + } +} diff --git a/clio-kit-mcp-servers/parquet/README.md b/clio-kit-mcp-servers/parquet/README.md index 61375f9a..b5226c87 100644 --- a/clio-kit-mcp-servers/parquet/README.md +++ b/clio-kit-mcp-servers/parquet/README.md @@ -284,3 +284,85 @@ MIT License - see LICENSE for details - **Zulip Invitation**: https://iowarp.zulipchat.com/join/e4wh24du356e4y2iw6x6jeay/ - **GitHub Issues**: https://github.com/iowarp/clio-kit/issues - **Email**: grc@illinoistech.edu + +## Capabilities + +### `summarize_tool` +**Description**: Return Parquet schema, row count, and file size. +**Hints**: read-only, idempotent +**Tags**: data-analysis, parquet + +### `read_slice_tool` +**Description**: Read a row slice from a Parquet file with optional column projection and filtering. +**Hints**: read-only, idempotent +**Tags**: data-analysis, parquet + +### `get_column_preview_tool` +**Description**: Preview values from a specific column with pagination. +**Hints**: read-only, idempotent +**Tags**: data-analysis, parquet + +### `aggregate_column_tool` +**Description**: Compute aggregate statistics (min, max, mean, etc.) on a Parquet column. +**Hints**: read-only, idempotent +**Tags**: data-analysis, parquet, statistics + +### Resources + +- `parquet://formats` - Supported Parquet features and capabilities. + +### Prompts + +- **analyze_parquet**: Guided workflow for analyzing a Parquet file. +## Claude Code + +```bash +claude mcp add clio-parquet -- uvx clio-kit parquet +``` + +Or install via the CLIO Kit plugin marketplace: + +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-parquet@iowarp-clio-kit +``` +## Claude Desktop + +Add to your Claude Desktop config (`claude_desktop_config.json`): + +```json +{ + "mcpServers": { + "clio-parquet": { + "command": "uvx", + "args": [ + "clio-kit", + "parquet" + ] + } + } +} +``` +## Gemini CLI + +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-parquet": { + "command": "uvx", + "args": [ + "clio-kit", + "parquet" + ] + } + } +} +``` + +Or install the CLIO Kit extension: + +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` \ No newline at end of file diff --git a/clio-kit-mcp-servers/parquet/pyproject.toml b/clio-kit-mcp-servers/parquet/pyproject.toml index 13f3ff81..7bbf09c2 100644 --- a/clio-kit-mcp-servers/parquet/pyproject.toml +++ b/clio-kit-mcp-servers/parquet/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["parquet", "columnar-data", "data-analysis", "scientific-computing", "mcp", "llm-integration", "apache-arrow"] dependencies = [ - "fastmcp>=2.13.0.1", + "fastmcp>=3.0.0rc2", "pyarrow>=22.0.0", "pydantic>=2.12.3", ] diff --git a/clio-kit-mcp-servers/parquet/server.json b/clio-kit-mcp-servers/parquet/server.json new file mode 100644 index 00000000..e6eff48e --- /dev/null +++ b/clio-kit-mcp-servers/parquet/server.json @@ -0,0 +1,51 @@ +{ + "name": "io.github.iowarp/parquet-mcp", + "description": "MCP server for Apache Parquet files", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "parquet" + ] + }, + "tools": [ + { + "name": "summarize_tool", + "description": "Return Parquet schema, row count, and file size." + }, + { + "name": "read_slice_tool", + "description": "Read a row slice from a Parquet file with optional column projection and filtering." + }, + { + "name": "get_column_preview_tool", + "description": "Preview values from a specific column with pagination." + }, + { + "name": "aggregate_column_tool", + "description": "Compute aggregate statistics (min, max, mean, etc.) on a Parquet column." + } + ], + "resources": [ + { + "uri": "parquet://formats", + "name": "supported_formats", + "description": "Supported Parquet features and capabilities." + } + ], + "prompts": [ + { + "name": "analyze_parquet", + "description": "Guided workflow for analyzing a Parquet file." + } + ], + "tags": [ + "parquet", + "apache-arrow", + "columnar-data", + "data-analysis" + ] +} diff --git a/clio-kit-mcp-servers/parquet/src/parquet_mcp/server.py b/clio-kit-mcp-servers/parquet/src/parquet_mcp/server.py index cc169b8d..5bded86f 100644 --- a/clio-kit-mcp-servers/parquet/src/parquet_mcp/server.py +++ b/clio-kit-mcp-servers/parquet/src/parquet_mcp/server.py @@ -1,7 +1,10 @@ """FastMCP server for Apache Parquet files.""" +import json from typing import Optional, List, Union from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message from parquet_mcp.capabilities.parquet_handler import ( summarize, read_slice, @@ -9,15 +12,39 @@ aggregate_column, ) -mcp = FastMCP("parquet-mcp") + +def _check_error(result: str) -> str: + """Check handler result for error status and raise ToolError if found.""" + try: + parsed = json.loads(result) + if isinstance(parsed, dict) and parsed.get("status") == "error": + raise ToolError(parsed.get("message", "Unknown error")) + except (json.JSONDecodeError, TypeError): + pass + return result + + +mcp = FastMCP( + "parquet", + instructions=( + "Reads and analyzes Apache Parquet files. " + "Use summarize_tool for file overview, read_slice_tool for row access, " + "get_column_preview_tool for column samples, aggregate_column_tool for statistics." + ), +) @mcp.tool( - description="Return structured JSON with Parquet schema, row count, and file size" + description="Return Parquet schema, row count, and file size.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"parquet", "data-analysis"}, ) async def summarize_tool(file_path: str) -> str: - """ - Summarize a Parquet file's structure and metadata. + """Summarize a Parquet file's structure and metadata. Args: file_path: Path to the Parquet file @@ -25,11 +52,17 @@ async def summarize_tool(file_path: str) -> str: Returns: JSON string with schema, row count, row groups, and file size """ - return await summarize(file_path) + return _check_error(await summarize(file_path)) @mcp.tool( - description="Read a horizontal slice of a Parquet file with optional column projection and filtering" + description="Read a row slice from a Parquet file with optional column projection and filtering.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"parquet", "data-analysis"}, ) async def read_slice_tool( file_path: str, @@ -38,8 +71,7 @@ async def read_slice_tool( columns: Optional[List[str]] = None, filter_json: Optional[str] = None, ) -> str: - """ - Read a specific range of rows from a Parquet file with optional column filtering and row filtering. + """Read a specific range of rows from a Parquet file. Args: file_path: Path to the Parquet file @@ -52,17 +84,24 @@ async def read_slice_tool( Returns: JSON string with status, schema, data, and shape information """ - return await read_slice(file_path, start_row, end_row, columns, filter_json) + return _check_error( + await read_slice(file_path, start_row, end_row, columns, filter_json) + ) @mcp.tool( - description="Get a preview of values from a specific column with pagination support" + description="Preview values from a specific column with pagination.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"parquet", "data-analysis"}, ) async def get_column_preview_tool( file_path: str, column_name: str, start_index: int = 0, max_items: int = 100 ) -> str: - """ - Get a preview of values from a named column in a Parquet file. + """Get a preview of values from a named column in a Parquet file. Args: file_path: Path to the Parquet file @@ -73,11 +112,19 @@ async def get_column_preview_tool( Returns: JSON string with column values, type info, and pagination metadata """ - return await get_column_preview(file_path, column_name, start_index, max_items) + return _check_error( + await get_column_preview(file_path, column_name, start_index, max_items) + ) @mcp.tool( - description="Compute aggregate statistics on a column with optional filtering" + description="Compute aggregate statistics (min, max, mean, etc.) on a Parquet column.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"parquet", "data-analysis", "statistics"}, ) async def aggregate_column_tool( file_path: str, @@ -87,8 +134,7 @@ async def aggregate_column_tool( start_row: Optional[Union[int, float]] = None, end_row: Optional[Union[int, float]] = None, ) -> str: - """ - Compute aggregate statistics on a column with optional filtering and range bounds. + """Compute aggregate statistics on a column with optional filtering and range bounds. Args: file_path: Path to the Parquet file @@ -102,32 +148,51 @@ async def aggregate_column_tool( Returns: JSON string with aggregation result and metadata """ - return await aggregate_column( - file_path, column_name, operation, filter_json, start_row, end_row + return _check_error( + await aggregate_column( + file_path, column_name, operation, filter_json, start_row, end_row + ) ) -def main(): - """Start the Parquet MCP server.""" - import sys - import logging - - # Configure logging - logging.basicConfig( - level=logging.INFO, - format="%(asctime)s - %(name)s - %(levelname)s - %(message)s", - ) - logger = logging.getLogger(__name__) - - try: - # Run with stdio transport (default for MCP) - logger.info("Starting Parquet MCP server with stdio transport") - mcp.run(transport="stdio") - except KeyboardInterrupt: - logger.info("Server stopped by user") - except Exception as e: - logger.error(f"Server failed: {e}") - sys.exit(1) +@mcp.resource("parquet://formats") +def supported_formats() -> dict: + """Supported Parquet features and capabilities.""" + return { + "read_formats": ["parquet"], + "compression_codecs": ["snappy", "gzip", "lz4", "zstd", "brotli"], + "features": ["column pruning", "row group filtering", "schema inspection"], + } + + +@mcp.prompt() +def analyze_parquet(file_path: str) -> list[Message]: + """Guided workflow for analyzing a Parquet file.""" + return [ + Message( + f"I need to analyze the Parquet file at {file_path}. " + "First summarize its schema and row count, then preview the first few columns, " + "and compute basic statistics on numeric columns." + ), + ] + + +def main() -> None: + """Main entry point for the Parquet MCP server.""" + import os + import argparse + + parser = argparse.ArgumentParser(description="Parquet MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/parquet/tests/test_server.py b/clio-kit-mcp-servers/parquet/tests/test_server.py index 41b64a7e..d51c2573 100644 --- a/clio-kit-mcp-servers/parquet/tests/test_server.py +++ b/clio-kit-mcp-servers/parquet/tests/test_server.py @@ -50,53 +50,21 @@ def test_main_function_exists(self): def test_main_initializes_mcp_server(self): """Test that main function initializes the MCP server.""" - with patch.object(server.mcp, "run") as mock_run: - mock_run.side_effect = KeyboardInterrupt() - - try: - server.main() - except (KeyboardInterrupt, SystemExit): - pass - - mock_run.assert_called_once_with(transport="stdio") - - def test_main_handles_keyboard_interrupt(self): - """Test that main handles KeyboardInterrupt gracefully.""" - with patch.object(server.mcp, "run") as mock_run: - mock_run.side_effect = KeyboardInterrupt() - - # Should not raise an exception - try: - server.main() - except SystemExit: - pytest.fail("main() should not exit on KeyboardInterrupt") - - def test_main_handles_exception(self): - """Test that main handles exceptions and exits with error code.""" - with patch.object(server.mcp, "run") as mock_run: - mock_run.side_effect = RuntimeError("Test error") - - with pytest.raises(SystemExit) as exc_info: + with patch("sys.argv", ["parquet-mcp"]): + with patch.object(server.mcp, "run") as mock_run: server.main() + mock_run.assert_called_once_with(transport="stdio") - assert exc_info.value.code == 1 - - def test_main_configures_logging(self): - """Test that main configures logging.""" - with patch("logging.basicConfig") as mock_config: + def test_main_with_http_transport(self): + """Test main with HTTP transport argument.""" + with patch( + "sys.argv", ["parquet-mcp", "--transport", "http", "--port", "9000"] + ): with patch.object(server.mcp, "run") as mock_run: - mock_run.side_effect = KeyboardInterrupt() - - try: - server.main() - except (KeyboardInterrupt, SystemExit): - pass - - # Check that basicConfig was called - mock_config.assert_called_once() - call_kwargs = mock_config.call_args[1] - assert "level" in call_kwargs - assert "format" in call_kwargs + server.main() + mock_run.assert_called_once_with( + transport="http", host="0.0.0.0", port=9000 + ) class TestMCPServerInstance: @@ -110,7 +78,7 @@ def test_mcp_server_is_fastmcp_instance(self): def test_mcp_server_name(self): """Test that MCP server has correct name.""" - assert server.mcp.name == "parquet-mcp" + assert server.mcp.name == "parquet" def test_mcp_server_has_tools_registered(self): """Test that MCP server has tools registered.""" @@ -120,30 +88,10 @@ def test_mcp_server_has_tools_registered(self): assert hasattr(server, "get_column_preview_tool") assert hasattr(server, "aggregate_column_tool") - def test_tools_are_function_tool_objects(self): - """Test that tools are wrapped in FunctionTool objects by FastMCP.""" - # FastMCP wraps decorated functions in FunctionTool objects - from fastmcp.tools import FunctionTool - - assert isinstance(server.summarize_tool, FunctionTool) - assert isinstance(server.read_slice_tool, FunctionTool) - assert isinstance(server.get_column_preview_tool, FunctionTool) - assert isinstance(server.aggregate_column_tool, FunctionTool) - - def test_tool_names(self): - """Test that tools have correct names.""" - assert server.summarize_tool.name == "summarize_tool" - assert server.read_slice_tool.name == "read_slice_tool" - assert server.get_column_preview_tool.name == "get_column_preview_tool" - assert server.aggregate_column_tool.name == "aggregate_column_tool" - - def test_tool_descriptions(self): - """Test that tools have descriptions.""" - assert server.summarize_tool.description is not None - assert len(server.summarize_tool.description) > 0 - assert server.read_slice_tool.description is not None - assert len(server.read_slice_tool.description) > 0 - assert server.get_column_preview_tool.description is not None - assert len(server.get_column_preview_tool.description) > 0 - assert server.aggregate_column_tool.description is not None - assert len(server.aggregate_column_tool.description) > 0 + def test_tools_are_callable(self): + """Test that tools are callable functions in FastMCP 3.0.""" + # In FastMCP 3.0, @mcp.tool() returns the original function, not a FunctionTool wrapper + assert callable(server.summarize_tool) + assert callable(server.read_slice_tool) + assert callable(server.get_column_preview_tool) + assert callable(server.aggregate_column_tool) diff --git a/clio-kit-mcp-servers/parquet/uv.lock b/clio-kit-mcp-servers/parquet/uv.lock index 3e3551ba..f4d0c5d3 100644 --- a/clio-kit-mcp-servers/parquet/uv.lock +++ b/clio-kit-mcp-servers/parquet/uv.lock @@ -533,27 +533,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.1" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, + { name = "jsonschema-path" }, { name = "mcp" }, - { name = "openapi-core" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/f2/bd/ad8a0cc9ea3e8bfe8fb63a00be985d4c887c3c0a454d26c712c160af489f/fastmcp-2.13.0.1.tar.gz", hash = "sha256:d6dbd52a6b06fc1797db9fe0b487db966b4a4d34d9c7dd87b9918d5ec775dcb7", size = 7768846, upload-time = "2025-10-26T15:43:00.567Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/90/0c/7e966e01240f7a9347d22d09e9d60cb46eaad68ca2ba24830755dab2c55c/fastmcp-2.13.0.1-py3-none-any.whl", hash = "sha256:60a8313b48803a2ddfad2d0fe8b9dd1f231aba7564c0551cad8447527ffe46e2", size = 367504, upload-time = "2025-10-26T15:42:58.98Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -632,15 +638,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" }, ] -[[package]] -name = "isodate" -version = "0.7.2" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/54/4d/e940025e2ce31a8ce1202635910747e5a87cc3a6a6bb2d00973375014749/isodate-0.7.2.tar.gz", hash = "sha256:4cd1aa0f43ca76f4a6c6c0292a85f40b35ec2e43e315b59f06e6d32171a953e6", size = 29705, upload-time = "2024-10-08T23:04:11.5Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/15/aa/0aca39a37d3c7eb941ba736ede56d689e7be91cab5d9ca846bde3999eba6/isodate-0.7.2-py3-none-any.whl", hash = "sha256:28009937d8031054830160fce6d409ed342816b543597cece116d966c6d99e15", size = 22320, upload-time = "2024-10-08T23:04:09.501Z" }, -] - [[package]] name = "jaraco-classes" version = "3.4.0" @@ -686,6 +683,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.25.1" @@ -746,51 +752,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d3/32/da7f44bcb1105d3e88a0b74ebdca50c59121d2ddf71c9e34ba47df7f3a56/keyring-25.6.0-py3-none-any.whl", hash = "sha256:552a3f7af126ece7ed5c89753650eec89c7eaae8617d0aa4d9ad2b75111266bd", size = 39085, upload-time = "2024-12-25T15:26:44.377Z" }, ] -[[package]] -name = "lazy-object-proxy" -version = "1.12.0" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/08/a2/69df9c6ba6d316cfd81fe2381e464db3e6de5db45f8c43c6a23504abf8cb/lazy_object_proxy-1.12.0.tar.gz", hash = "sha256:1f5a462d92fd0cfb82f1fab28b51bfb209fabbe6aabf7f0d51472c0c124c0c61", size = 43681, upload-time = "2025-08-22T13:50:06.783Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/d6/2b/d5e8915038acbd6c6a9fcb8aaf923dc184222405d3710285a1fec6e262bc/lazy_object_proxy-1.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:61d5e3310a4aa5792c2b599a7a78ccf8687292c8eb09cf187cca8f09cf6a7519", size = 26658, upload-time = "2025-08-22T13:42:23.373Z" }, - { url = "https://files.pythonhosted.org/packages/da/8f/91fc00eeea46ee88b9df67f7c5388e60993341d2a406243d620b2fdfde57/lazy_object_proxy-1.12.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c1ca33565f698ac1aece152a10f432415d1a2aa9a42dfe23e5ba2bc255ab91f6", size = 68412, upload-time = "2025-08-22T13:42:24.727Z" }, - { url = "https://files.pythonhosted.org/packages/07/d2/b7189a0e095caedfea4d42e6b6949d2685c354263bdf18e19b21ca9b3cd6/lazy_object_proxy-1.12.0-cp310-cp310-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d01c7819a410f7c255b20799b65d36b414379a30c6f1684c7bd7eb6777338c1b", size = 67559, upload-time = "2025-08-22T13:42:25.875Z" }, - { url = "https://files.pythonhosted.org/packages/a3/ad/b013840cc43971582ff1ceaf784d35d3a579650eb6cc348e5e6ed7e34d28/lazy_object_proxy-1.12.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:029d2b355076710505c9545aef5ab3f750d89779310e26ddf2b7b23f6ea03cd8", size = 66651, upload-time = "2025-08-22T13:42:27.427Z" }, - { url = "https://files.pythonhosted.org/packages/7e/6f/b7368d301c15612fcc4cd00412b5d6ba55548bde09bdae71930e1a81f2ab/lazy_object_proxy-1.12.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:cc6e3614eca88b1c8a625fc0a47d0d745e7c3255b21dac0e30b3037c5e3deeb8", size = 66901, upload-time = "2025-08-22T13:42:28.585Z" }, - { url = "https://files.pythonhosted.org/packages/61/1b/c6b1865445576b2fc5fa0fbcfce1c05fee77d8979fd1aa653dd0f179aefc/lazy_object_proxy-1.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:be5fe974e39ceb0d6c9db0663c0464669cf866b2851c73971409b9566e880eab", size = 26536, upload-time = "2025-08-22T13:42:29.636Z" }, - { url = "https://files.pythonhosted.org/packages/01/b3/4684b1e128a87821e485f5a901b179790e6b5bc02f89b7ee19c23be36ef3/lazy_object_proxy-1.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1cf69cd1a6c7fe2dbcc3edaa017cf010f4192e53796538cc7d5e1fedbfa4bcff", size = 26656, upload-time = "2025-08-22T13:42:30.605Z" }, - { url = "https://files.pythonhosted.org/packages/3a/03/1bdc21d9a6df9ff72d70b2ff17d8609321bea4b0d3cffd2cea92fb2ef738/lazy_object_proxy-1.12.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:efff4375a8c52f55a145dc8487a2108c2140f0bec4151ab4e1843e52eb9987ad", size = 68832, upload-time = "2025-08-22T13:42:31.675Z" }, - { url = "https://files.pythonhosted.org/packages/3d/4b/5788e5e8bd01d19af71e50077ab020bc5cce67e935066cd65e1215a09ff9/lazy_object_proxy-1.12.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1192e8c2f1031a6ff453ee40213afa01ba765b3dc861302cd91dbdb2e2660b00", size = 69148, upload-time = "2025-08-22T13:42:32.876Z" }, - { url = "https://files.pythonhosted.org/packages/79/0e/090bf070f7a0de44c61659cb7f74c2fe02309a77ca8c4b43adfe0b695f66/lazy_object_proxy-1.12.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:3605b632e82a1cbc32a1e5034278a64db555b3496e0795723ee697006b980508", size = 67800, upload-time = "2025-08-22T13:42:34.054Z" }, - { url = "https://files.pythonhosted.org/packages/cf/d2/b320325adbb2d119156f7c506a5fbfa37fcab15c26d13cf789a90a6de04e/lazy_object_proxy-1.12.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:a61095f5d9d1a743e1e20ec6d6db6c2ca511961777257ebd9b288951b23b44fa", size = 68085, upload-time = "2025-08-22T13:42:35.197Z" }, - { url = "https://files.pythonhosted.org/packages/6a/48/4b718c937004bf71cd82af3713874656bcb8d0cc78600bf33bb9619adc6c/lazy_object_proxy-1.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:997b1d6e10ecc6fb6fe0f2c959791ae59599f41da61d652f6c903d1ee58b7370", size = 26535, upload-time = "2025-08-22T13:42:36.521Z" }, - { url = "https://files.pythonhosted.org/packages/0d/1b/b5f5bd6bda26f1e15cd3232b223892e4498e34ec70a7f4f11c401ac969f1/lazy_object_proxy-1.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8ee0d6027b760a11cc18281e702c0309dd92da458a74b4c15025d7fc490deede", size = 26746, upload-time = "2025-08-22T13:42:37.572Z" }, - { url = "https://files.pythonhosted.org/packages/55/64/314889b618075c2bfc19293ffa9153ce880ac6153aacfd0a52fcabf21a66/lazy_object_proxy-1.12.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:4ab2c584e3cc8be0dfca422e05ad30a9abe3555ce63e9ab7a559f62f8dbc6ff9", size = 71457, upload-time = "2025-08-22T13:42:38.743Z" }, - { url = "https://files.pythonhosted.org/packages/11/53/857fc2827fc1e13fbdfc0ba2629a7d2579645a06192d5461809540b78913/lazy_object_proxy-1.12.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:14e348185adbd03ec17d051e169ec45686dcd840a3779c9d4c10aabe2ca6e1c0", size = 71036, upload-time = "2025-08-22T13:42:40.184Z" }, - { url = "https://files.pythonhosted.org/packages/2b/24/e581ffed864cd33c1b445b5763d617448ebb880f48675fc9de0471a95cbc/lazy_object_proxy-1.12.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:c4fcbe74fb85df8ba7825fa05eddca764138da752904b378f0ae5ab33a36c308", size = 69329, upload-time = "2025-08-22T13:42:41.311Z" }, - { url = "https://files.pythonhosted.org/packages/78/be/15f8f5a0b0b2e668e756a152257d26370132c97f2f1943329b08f057eff0/lazy_object_proxy-1.12.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:563d2ec8e4d4b68ee7848c5ab4d6057a6d703cb7963b342968bb8758dda33a23", size = 70690, upload-time = "2025-08-22T13:42:42.51Z" }, - { url = "https://files.pythonhosted.org/packages/5d/aa/f02be9bbfb270e13ee608c2b28b8771f20a5f64356c6d9317b20043c6129/lazy_object_proxy-1.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:53c7fd99eb156bbb82cbc5d5188891d8fdd805ba6c1e3b92b90092da2a837073", size = 26563, upload-time = "2025-08-22T13:42:43.685Z" }, - { url = "https://files.pythonhosted.org/packages/f4/26/b74c791008841f8ad896c7f293415136c66cc27e7c7577de4ee68040c110/lazy_object_proxy-1.12.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:86fd61cb2ba249b9f436d789d1356deae69ad3231dc3c0f17293ac535162672e", size = 26745, upload-time = "2025-08-22T13:42:44.982Z" }, - { url = "https://files.pythonhosted.org/packages/9b/52/641870d309e5d1fb1ea7d462a818ca727e43bfa431d8c34b173eb090348c/lazy_object_proxy-1.12.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:81d1852fb30fab81696f93db1b1e55a5d1ff7940838191062f5f56987d5fcc3e", size = 71537, upload-time = "2025-08-22T13:42:46.141Z" }, - { url = "https://files.pythonhosted.org/packages/47/b6/919118e99d51c5e76e8bf5a27df406884921c0acf2c7b8a3b38d847ab3e9/lazy_object_proxy-1.12.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:be9045646d83f6c2664c1330904b245ae2371b5c57a3195e4028aedc9f999655", size = 71141, upload-time = "2025-08-22T13:42:47.375Z" }, - { url = "https://files.pythonhosted.org/packages/e5/47/1d20e626567b41de085cf4d4fb3661a56c159feaa73c825917b3b4d4f806/lazy_object_proxy-1.12.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:67f07ab742f1adfb3966c40f630baaa7902be4222a17941f3d85fd1dae5565ff", size = 69449, upload-time = "2025-08-22T13:42:48.49Z" }, - { url = "https://files.pythonhosted.org/packages/58/8d/25c20ff1a1a8426d9af2d0b6f29f6388005fc8cd10d6ee71f48bff86fdd0/lazy_object_proxy-1.12.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:75ba769017b944fcacbf6a80c18b2761a1795b03f8899acdad1f1c39db4409be", size = 70744, upload-time = "2025-08-22T13:42:49.608Z" }, - { url = "https://files.pythonhosted.org/packages/c0/67/8ec9abe15c4f8a4bcc6e65160a2c667240d025cbb6591b879bea55625263/lazy_object_proxy-1.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:7b22c2bbfb155706b928ac4d74c1a63ac8552a55ba7fff4445155523ea4067e1", size = 26568, upload-time = "2025-08-22T13:42:57.719Z" }, - { url = "https://files.pythonhosted.org/packages/23/12/cd2235463f3469fd6c62d41d92b7f120e8134f76e52421413a0ad16d493e/lazy_object_proxy-1.12.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4a79b909aa16bde8ae606f06e6bbc9d3219d2e57fb3e0076e17879072b742c65", size = 27391, upload-time = "2025-08-22T13:42:50.62Z" }, - { url = "https://files.pythonhosted.org/packages/60/9e/f1c53e39bbebad2e8609c67d0830cc275f694d0ea23d78e8f6db526c12d3/lazy_object_proxy-1.12.0-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:338ab2f132276203e404951205fe80c3fd59429b3a724e7b662b2eb539bb1be9", size = 80552, upload-time = "2025-08-22T13:42:51.731Z" }, - { url = "https://files.pythonhosted.org/packages/4c/b6/6c513693448dcb317d9d8c91d91f47addc09553613379e504435b4cc8b3e/lazy_object_proxy-1.12.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8c40b3c9faee2e32bfce0df4ae63f4e73529766893258eca78548bac801c8f66", size = 82857, upload-time = "2025-08-22T13:42:53.225Z" }, - { url = "https://files.pythonhosted.org/packages/12/1c/d9c4aaa4c75da11eb7c22c43d7c90a53b4fca0e27784a5ab207768debea7/lazy_object_proxy-1.12.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:717484c309df78cedf48396e420fa57fc8a2b1f06ea889df7248fdd156e58847", size = 80833, upload-time = "2025-08-22T13:42:54.391Z" }, - { url = "https://files.pythonhosted.org/packages/0b/ae/29117275aac7d7d78ae4f5a4787f36ff33262499d486ac0bf3e0b97889f6/lazy_object_proxy-1.12.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:a6b7ea5ea1ffe15059eb44bcbcb258f97bcb40e139b88152c40d07b1a1dfc9ac", size = 79516, upload-time = "2025-08-22T13:42:55.812Z" }, - { url = "https://files.pythonhosted.org/packages/19/40/b4e48b2c38c69392ae702ae7afa7b6551e0ca5d38263198b7c79de8b3bdf/lazy_object_proxy-1.12.0-cp313-cp313t-win_amd64.whl", hash = "sha256:08c465fb5cd23527512f9bd7b4c7ba6cec33e28aad36fbbe46bf7b858f9f3f7f", size = 27656, upload-time = "2025-08-22T13:42:56.793Z" }, - { url = "https://files.pythonhosted.org/packages/ef/3a/277857b51ae419a1574557c0b12e0d06bf327b758ba94cafc664cb1e2f66/lazy_object_proxy-1.12.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c9defba70ab943f1df98a656247966d7729da2fe9c2d5d85346464bf320820a3", size = 26582, upload-time = "2025-08-22T13:49:49.366Z" }, - { url = "https://files.pythonhosted.org/packages/1a/b6/c5e0fa43535bb9c87880e0ba037cdb1c50e01850b0831e80eb4f4762f270/lazy_object_proxy-1.12.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:6763941dbf97eea6b90f5b06eb4da9418cc088fce0e3883f5816090f9afcde4a", size = 71059, upload-time = "2025-08-22T13:49:50.488Z" }, - { url = "https://files.pythonhosted.org/packages/06/8a/7dcad19c685963c652624702f1a968ff10220b16bfcc442257038216bf55/lazy_object_proxy-1.12.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fdc70d81235fc586b9e3d1aeef7d1553259b62ecaae9db2167a5d2550dcc391a", size = 71034, upload-time = "2025-08-22T13:49:54.224Z" }, - { url = "https://files.pythonhosted.org/packages/12/ac/34cbfb433a10e28c7fd830f91c5a348462ba748413cbb950c7f259e67aa7/lazy_object_proxy-1.12.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0a83c6f7a6b2bfc11ef3ed67f8cbe99f8ff500b05655d8e7df9aab993a6abc95", size = 69529, upload-time = "2025-08-22T13:49:55.29Z" }, - { url = "https://files.pythonhosted.org/packages/6f/6a/11ad7e349307c3ca4c0175db7a77d60ce42a41c60bcb11800aabd6a8acb8/lazy_object_proxy-1.12.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:256262384ebd2a77b023ad02fbcc9326282bcfd16484d5531154b02bc304f4c5", size = 70391, upload-time = "2025-08-22T13:49:56.35Z" }, - { url = "https://files.pythonhosted.org/packages/59/97/9b410ed8fbc6e79c1ee8b13f8777a80137d4bc189caf2c6202358e66192c/lazy_object_proxy-1.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:7601ec171c7e8584f8ff3f4e440aa2eebf93e854f04639263875b8c2971f819f", size = 26988, upload-time = "2025-08-22T13:49:57.302Z" }, - { url = "https://files.pythonhosted.org/packages/41/a0/b91504515c1f9a299fc157967ffbd2f0321bce0516a3d5b89f6f4cad0355/lazy_object_proxy-1.12.0-pp39.pp310.pp311.graalpy311-none-any.whl", hash = "sha256:c3b2e0af1f7f77c4263759c4824316ce458fabe0fceadcd24ef8ca08b2d1e402", size = 15072, upload-time = "2025-08-22T13:50:05.498Z" }, -] - [[package]] name = "markdown-it-py" version = "4.0.0" @@ -803,94 +764,9 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" }, ] -[[package]] -name = "markupsafe" -version = "3.0.3" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313, upload-time = "2025-09-27T18:37:40.426Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/e8/4b/3541d44f3937ba468b75da9eebcae497dcf67adb65caa16760b0a6807ebb/markupsafe-3.0.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559", size = 11631, upload-time = "2025-09-27T18:36:05.558Z" }, - { url = "https://files.pythonhosted.org/packages/98/1b/fbd8eed11021cabd9226c37342fa6ca4e8a98d8188a8d9b66740494960e4/markupsafe-3.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419", size = 12057, upload-time = "2025-09-27T18:36:07.165Z" }, - { url = "https://files.pythonhosted.org/packages/40/01/e560d658dc0bb8ab762670ece35281dec7b6c1b33f5fbc09ebb57a185519/markupsafe-3.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695", size = 22050, upload-time = "2025-09-27T18:36:08.005Z" }, - { url = "https://files.pythonhosted.org/packages/af/cd/ce6e848bbf2c32314c9b237839119c5a564a59725b53157c856e90937b7a/markupsafe-3.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591", size = 20681, upload-time = "2025-09-27T18:36:08.881Z" }, - { url = "https://files.pythonhosted.org/packages/c9/2a/b5c12c809f1c3045c4d580b035a743d12fcde53cf685dbc44660826308da/markupsafe-3.0.3-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c", size = 20705, upload-time = "2025-09-27T18:36:10.131Z" }, - { url = "https://files.pythonhosted.org/packages/cf/e3/9427a68c82728d0a88c50f890d0fc072a1484de2f3ac1ad0bfc1a7214fd5/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f", size = 21524, upload-time = "2025-09-27T18:36:11.324Z" }, - { url = "https://files.pythonhosted.org/packages/bc/36/23578f29e9e582a4d0278e009b38081dbe363c5e7165113fad546918a232/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6", size = 20282, upload-time = "2025-09-27T18:36:12.573Z" }, - { url = "https://files.pythonhosted.org/packages/56/21/dca11354e756ebd03e036bd8ad58d6d7168c80ce1fe5e75218e4945cbab7/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1", size = 20745, upload-time = "2025-09-27T18:36:13.504Z" }, - { url = "https://files.pythonhosted.org/packages/87/99/faba9369a7ad6e4d10b6a5fbf71fa2a188fe4a593b15f0963b73859a1bbd/markupsafe-3.0.3-cp310-cp310-win32.whl", hash = "sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa", size = 14571, upload-time = "2025-09-27T18:36:14.779Z" }, - { url = "https://files.pythonhosted.org/packages/d6/25/55dc3ab959917602c96985cb1253efaa4ff42f71194bddeb61eb7278b8be/markupsafe-3.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8", size = 15056, upload-time = "2025-09-27T18:36:16.125Z" }, - { url = "https://files.pythonhosted.org/packages/d0/9e/0a02226640c255d1da0b8d12e24ac2aa6734da68bff14c05dd53b94a0fc3/markupsafe-3.0.3-cp310-cp310-win_arm64.whl", hash = "sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1", size = 13932, upload-time = "2025-09-27T18:36:17.311Z" }, - { url = "https://files.pythonhosted.org/packages/08/db/fefacb2136439fc8dd20e797950e749aa1f4997ed584c62cfb8ef7c2be0e/markupsafe-3.0.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad", size = 11631, upload-time = "2025-09-27T18:36:18.185Z" }, - { url = "https://files.pythonhosted.org/packages/e1/2e/5898933336b61975ce9dc04decbc0a7f2fee78c30353c5efba7f2d6ff27a/markupsafe-3.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a", size = 12058, upload-time = "2025-09-27T18:36:19.444Z" }, - { url = "https://files.pythonhosted.org/packages/1d/09/adf2df3699d87d1d8184038df46a9c80d78c0148492323f4693df54e17bb/markupsafe-3.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50", size = 24287, upload-time = "2025-09-27T18:36:20.768Z" }, - { url = "https://files.pythonhosted.org/packages/30/ac/0273f6fcb5f42e314c6d8cd99effae6a5354604d461b8d392b5ec9530a54/markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf", size = 22940, upload-time = "2025-09-27T18:36:22.249Z" }, - { url = "https://files.pythonhosted.org/packages/19/ae/31c1be199ef767124c042c6c3e904da327a2f7f0cd63a0337e1eca2967a8/markupsafe-3.0.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f", size = 21887, upload-time = "2025-09-27T18:36:23.535Z" }, - { url = "https://files.pythonhosted.org/packages/b2/76/7edcab99d5349a4532a459e1fe64f0b0467a3365056ae550d3bcf3f79e1e/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a", size = 23692, upload-time = "2025-09-27T18:36:24.823Z" }, - { url = "https://files.pythonhosted.org/packages/a4/28/6e74cdd26d7514849143d69f0bf2399f929c37dc2b31e6829fd2045b2765/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115", size = 21471, upload-time = "2025-09-27T18:36:25.95Z" }, - { url = "https://files.pythonhosted.org/packages/62/7e/a145f36a5c2945673e590850a6f8014318d5577ed7e5920a4b3448e0865d/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a", size = 22923, upload-time = "2025-09-27T18:36:27.109Z" }, - { url = "https://files.pythonhosted.org/packages/0f/62/d9c46a7f5c9adbeeeda52f5b8d802e1094e9717705a645efc71b0913a0a8/markupsafe-3.0.3-cp311-cp311-win32.whl", hash = "sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19", size = 14572, upload-time = "2025-09-27T18:36:28.045Z" }, - { url = "https://files.pythonhosted.org/packages/83/8a/4414c03d3f891739326e1783338e48fb49781cc915b2e0ee052aa490d586/markupsafe-3.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01", size = 15077, upload-time = "2025-09-27T18:36:29.025Z" }, - { url = "https://files.pythonhosted.org/packages/35/73/893072b42e6862f319b5207adc9ae06070f095b358655f077f69a35601f0/markupsafe-3.0.3-cp311-cp311-win_arm64.whl", hash = "sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c", size = 13876, upload-time = "2025-09-27T18:36:29.954Z" }, - { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615, upload-time = "2025-09-27T18:36:30.854Z" }, - { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020, upload-time = "2025-09-27T18:36:31.971Z" }, - { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332, upload-time = "2025-09-27T18:36:32.813Z" }, - { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947, upload-time = "2025-09-27T18:36:33.86Z" }, - { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962, upload-time = "2025-09-27T18:36:35.099Z" }, - { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760, upload-time = "2025-09-27T18:36:36.001Z" }, - { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529, upload-time = "2025-09-27T18:36:36.906Z" }, - { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015, upload-time = "2025-09-27T18:36:37.868Z" }, - { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540, upload-time = "2025-09-27T18:36:38.761Z" }, - { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105, upload-time = "2025-09-27T18:36:39.701Z" }, - { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906, upload-time = "2025-09-27T18:36:40.689Z" }, - { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622, upload-time = "2025-09-27T18:36:41.777Z" }, - { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029, upload-time = "2025-09-27T18:36:43.257Z" }, - { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374, upload-time = "2025-09-27T18:36:44.508Z" }, - { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980, upload-time = "2025-09-27T18:36:45.385Z" }, - { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990, upload-time = "2025-09-27T18:36:46.916Z" }, - { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784, upload-time = "2025-09-27T18:36:47.884Z" }, - { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588, upload-time = "2025-09-27T18:36:48.82Z" }, - { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041, upload-time = "2025-09-27T18:36:49.797Z" }, - { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543, upload-time = "2025-09-27T18:36:51.584Z" }, - { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113, upload-time = "2025-09-27T18:36:52.537Z" }, - { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911, upload-time = "2025-09-27T18:36:53.513Z" }, - { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658, upload-time = "2025-09-27T18:36:54.819Z" }, - { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066, upload-time = "2025-09-27T18:36:55.714Z" }, - { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639, upload-time = "2025-09-27T18:36:56.908Z" }, - { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569, upload-time = "2025-09-27T18:36:57.913Z" }, - { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284, upload-time = "2025-09-27T18:36:58.833Z" }, - { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801, upload-time = "2025-09-27T18:36:59.739Z" }, - { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769, upload-time = "2025-09-27T18:37:00.719Z" }, - { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642, upload-time = "2025-09-27T18:37:01.673Z" }, - { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612, upload-time = "2025-09-27T18:37:02.639Z" }, - { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200, upload-time = "2025-09-27T18:37:03.582Z" }, - { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973, upload-time = "2025-09-27T18:37:04.929Z" }, - { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619, upload-time = "2025-09-27T18:37:06.342Z" }, - { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029, upload-time = "2025-09-27T18:37:07.213Z" }, - { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408, upload-time = "2025-09-27T18:37:09.572Z" }, - { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005, upload-time = "2025-09-27T18:37:10.58Z" }, - { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048, upload-time = "2025-09-27T18:37:11.547Z" }, - { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821, upload-time = "2025-09-27T18:37:12.48Z" }, - { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606, upload-time = "2025-09-27T18:37:13.485Z" }, - { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043, upload-time = "2025-09-27T18:37:14.408Z" }, - { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747, upload-time = "2025-09-27T18:37:15.36Z" }, - { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341, upload-time = "2025-09-27T18:37:16.496Z" }, - { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073, upload-time = "2025-09-27T18:37:17.476Z" }, - { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661, upload-time = "2025-09-27T18:37:18.453Z" }, - { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069, upload-time = "2025-09-27T18:37:19.332Z" }, - { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670, upload-time = "2025-09-27T18:37:20.245Z" }, - { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598, upload-time = "2025-09-27T18:37:21.177Z" }, - { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261, upload-time = "2025-09-27T18:37:22.167Z" }, - { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835, upload-time = "2025-09-27T18:37:23.296Z" }, - { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733, upload-time = "2025-09-27T18:37:24.237Z" }, - { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672, upload-time = "2025-09-27T18:37:25.271Z" }, - { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819, upload-time = "2025-09-27T18:37:26.285Z" }, - { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426, upload-time = "2025-09-27T18:37:27.316Z" }, - { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146, upload-time = "2025-09-27T18:37:28.327Z" }, -] - [[package]] name = "mcp" -version = "1.19.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -899,15 +775,18 @@ dependencies = [ { name = "jsonschema" }, { name = "pydantic" }, { name = "pydantic-settings" }, + { name = "pyjwt", extra = ["crypto"] }, { name = "python-multipart" }, { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/69/2b/916852a5668f45d8787378461eaa1244876d77575ffef024483c94c0649c/mcp-1.19.0.tar.gz", hash = "sha256:213de0d3cd63f71bc08ffe9cc8d4409cc87acffd383f6195d2ce0457c021b5c1", size = 444163, upload-time = "2025-10-24T01:11:15.839Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/ce/a3/3e71a875a08b6a830b88c40bc413bff01f1650f1efe8a054b5e90a9d4f56/mcp-1.19.0-py3-none-any.whl", hash = "sha256:f5907fe1c0167255f916718f376d05f09a830a215327a3ccdd5ec8a519f2e572", size = 170105, upload-time = "2025-10-24T01:11:14.151Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -928,26 +807,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/a4/8e/469e5a4a2f5855992e425f3cb33804cc07bf18d48f2db061aec61ce50270/more_itertools-10.8.0-py3-none-any.whl", hash = "sha256:52d4362373dcf7c52546bc4af9a86ee7c4579df9a8dc268be0a2f949d376cc9b", size = 69667, upload-time = "2025-09-02T15:23:09.635Z" }, ] -[[package]] -name = "openapi-core" -version = "0.19.5" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "isodate" }, - { name = "jsonschema" }, - { name = "jsonschema-path" }, - { name = "more-itertools" }, - { name = "openapi-schema-validator" }, - { name = "openapi-spec-validator" }, - { name = "parse" }, - { name = "typing-extensions" }, - { name = "werkzeug" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/b1/35/1acaa5f2fcc6e54eded34a2ec74b479439c4e469fc4e8d0e803fda0234db/openapi_core-0.19.5.tar.gz", hash = "sha256:421e753da56c391704454e66afe4803a290108590ac8fa6f4a4487f4ec11f2d3", size = 103264, upload-time = "2025-03-20T20:17:28.193Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/27/6f/83ead0e2e30a90445ee4fc0135f43741aebc30cca5b43f20968b603e30b6/openapi_core-0.19.5-py3-none-any.whl", hash = "sha256:ef7210e83a59394f46ce282639d8d26ad6fc8094aa904c9c16eb1bac8908911f", size = 106595, upload-time = "2025-03-20T20:17:26.77Z" }, -] - [[package]] name = "openapi-pydantic" version = "0.5.1" @@ -961,32 +820,16 @@ wheels = [ ] [[package]] -name = "openapi-schema-validator" -version = "0.6.3" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "jsonschema" }, - { name = "jsonschema-specifications" }, - { name = "rfc3339-validator" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/8b/f3/5507ad3325169347cd8ced61c232ff3df70e2b250c49f0fe140edb4973c6/openapi_schema_validator-0.6.3.tar.gz", hash = "sha256:f37bace4fc2a5d96692f4f8b31dc0f8d7400fd04f3a937798eaf880d425de6ee", size = 11550, upload-time = "2025-01-10T18:08:22.268Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/21/c6/ad0fba32775ae749016829dace42ed80f4407b171da41313d1a3a5f102e4/openapi_schema_validator-0.6.3-py3-none-any.whl", hash = "sha256:f3b9870f4e556b5a62a1c39da72a6b4b16f3ad9c73dc80084b1b11e74ba148a3", size = 8755, upload-time = "2025-01-10T18:08:19.758Z" }, -] - -[[package]] -name = "openapi-spec-validator" -version = "0.7.2" +name = "opentelemetry-api" +version = "1.39.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "jsonschema" }, - { name = "jsonschema-path" }, - { name = "lazy-object-proxy" }, - { name = "openapi-schema-validator" }, + { name = "importlib-metadata" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/82/af/fe2d7618d6eae6fb3a82766a44ed87cd8d6d82b4564ed1c7cfb0f6378e91/openapi_spec_validator-0.7.2.tar.gz", hash = "sha256:cc029309b5c5dbc7859df0372d55e9d1ff43e96d678b9ba087f7c56fc586f734", size = 36855, upload-time = "2025-06-07T14:48:56.299Z" } +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/27/dd/b3fd642260cb17532f66cc1e8250f3507d1e580483e209dc1e9d13bd980d/openapi_spec_validator-0.7.2-py3-none-any.whl", hash = "sha256:4bbdc0894ec85f1d1bea1d6d9c8b2c3c8d7ccaa13577ef40da9c006c9fd0eb60", size = 39713, upload-time = "2025-06-07T14:48:54.077Z" }, + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, ] [[package]] @@ -1018,7 +861,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0.1" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "pyarrow", specifier = ">=22.0.0" }, { name = "pydantic", specifier = ">=2.12.3" }, ] @@ -1031,15 +874,6 @@ dev = [ { name = "ruff", specifier = ">=0.12.5" }, ] -[[package]] -name = "parse" -version = "1.20.2" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/4f/78/d9b09ba24bb36ef8b83b71be547e118d46214735b6dfb39e4bfde0e9b9dd/parse-1.20.2.tar.gz", hash = "sha256:b41d604d16503c79d81af5165155c0b20f6c8d6c559efa66b4b695c3e5a0a0ce", size = 29391, upload-time = "2024-06-11T04:41:57.34Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/d0/31/ba45bf0b2aa7898d81cbbfac0e88c267befb59ad91a19e36e1bc5578ddb1/parse-1.20.2-py2.py3-none-any.whl", hash = "sha256:967095588cb802add9177d0c0b6133b5ba33b1ea9007ca800e526f42a85af558", size = 20126, upload-time = "2024-06-11T04:41:55.057Z" }, -] - [[package]] name = "pathable" version = "0.4.4" @@ -1078,15 +912,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1101,19 +935,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pyarrow" version = "22.0.0" @@ -1337,6 +1158,20 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" }, ] +[[package]] +name = "pyjwt" +version = "2.11.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/5c/5a/b46fa56bf322901eee5b0454a34343cdbdae202cd421775a8ee4e42fd519/pyjwt-2.11.0.tar.gz", hash = "sha256:35f95c1f0fbe5d5ba6e43f00271c275f7a1a4db1dab27bf708073b75318ea623", size = 98019, upload-time = "2026-01-30T19:59:55.694Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/6f/01/c26ce75ba460d5cd503da9e13b21a33804d38c2165dec7b716d06b13010c/pyjwt-2.11.0-py3-none-any.whl", hash = "sha256:94a6bde30eb5c8e04fee991062b534071fd1439ef58d2adc9ccb823e7bcd0469", size = 28224, upload-time = "2026-01-30T19:59:54.539Z" }, +] + +[package.optional-dependencies] +crypto = [ + { name = "cryptography" }, +] + [[package]] name = "pyperclip" version = "1.11.0" @@ -1534,18 +1369,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" }, ] -[[package]] -name = "rfc3339-validator" -version = "0.1.4" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "six" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/28/ea/a9387748e2d111c3c2b275ba970b735e04e15cdb1eb30693b6b5708c4dbd/rfc3339_validator-0.1.4.tar.gz", hash = "sha256:138a2abdf93304ad60530167e51d2dfb9549521a836871b88d7f4695d0022f6b", size = 5513, upload-time = "2021-05-12T16:37:54.178Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/7b/44/4e421b96b67b2daff264473f7465db72fbdf36a07e05494f50300cc7b0c6/rfc3339_validator-0.1.4-py2.py3-none-any.whl", hash = "sha256:24f6ec1eda14ef823da9e36ec7113124b39c04d50a4d3d3a3c2859577e7791fa", size = 3490, upload-time = "2021-05-12T16:37:52.536Z" }, -] - [[package]] name = "rich" version = "14.2.0" @@ -1733,15 +1556,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/91/ff/2e2eed29e02c14a5cb6c57f09b2d5b40e65d6cc71f45b52e0be295ccbc2f/secretstorage-3.4.0-py3-none-any.whl", hash = "sha256:0e3b6265c2c63509fb7415717607e4b2c9ab767b7f344a57473b779ca13bd02e", size = 15272, upload-time = "2025-09-09T16:42:12.744Z" }, ] -[[package]] -name = "six" -version = "1.17.0" -source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031, upload-time = "2024-12-04T17:35:28.174Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" }, -] - [[package]] name = "sniffio" version = "1.3.1" @@ -1869,6 +1683,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/ee/d9/d88e73ca598f4f6ff671fb5fde8a32925c2e08a637303a1d12883c7305fa/uvicorn-0.38.0-py3-none-any.whl", hash = "sha256:48c0afd214ceb59340075b4a052ea1ee91c16fbc2a9b1469cca0e54566977b02", size = 68109, upload-time = "2025-10-18T13:46:42.958Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" @@ -1928,18 +1845,6 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/fa/a8/5b41e0da817d64113292ab1f8247140aac61cbf6cfd085d6a0fa77f4984f/websockets-15.0.1-py3-none-any.whl", hash = "sha256:f7a866fbc1e97b5c617ee4116daaa09b722101d4a3c170c787450ba409f9736f", size = 169743, upload-time = "2025-03-05T20:03:39.41Z" }, ] -[[package]] -name = "werkzeug" -version = "3.1.1" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "markupsafe" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/32/af/d4502dc713b4ccea7175d764718d5183caf8d0867a4f0190d5d4a45cea49/werkzeug-3.1.1.tar.gz", hash = "sha256:8cd39dfbdfc1e051965f156163e2974e52c210f130810e9ad36858f0fd3edad4", size = 806453, upload-time = "2024-11-01T16:40:45.462Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/ee/ea/c67e1dee1ba208ed22c06d1d547ae5e293374bfc43e0eb0ef5e262b68561/werkzeug-3.1.1-py3-none-any.whl", hash = "sha256:a71124d1ef06008baafa3d266c02f56e1836a5984afd6dd6c9230669d60d9fb5", size = 224371, upload-time = "2024-11-01T16:40:43.994Z" }, -] - [[package]] name = "zipp" version = "3.23.0" diff --git a/clio-kit-mcp-servers/plot/.claude-plugin/plugin.json b/clio-kit-mcp-servers/plot/.claude-plugin/plugin.json new file mode 100644 index 00000000..dcfaf2fa --- /dev/null +++ b/clio-kit-mcp-servers/plot/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-plot", + "description": "MCP server for advanced data visualization and plotting operations", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/plot/.mcp.json b/clio-kit-mcp-servers/plot/.mcp.json new file mode 100644 index 00000000..f7e04062 --- /dev/null +++ b/clio-kit-mcp-servers/plot/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-plot": { + "command": "uvx", + "args": [ + "clio-kit", + "plot" + ] + } +} diff --git a/clio-kit-mcp-servers/plot/README.md b/clio-kit-mcp-servers/plot/README.md index cdaea668..b487f2c6 100644 --- a/clio-kit-mcp-servers/plot/README.md +++ b/clio-kit-mcp-servers/plot/README.md @@ -131,70 +131,94 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\plot run plot-mcp -- ## Capabilities ### `line_plot` -**Description**: Create a line plot from data file with comprehensive visualization options. +**Description**: Create a line plot from CSV or Excel data with customizable styling. +**Hints**: destructive, idempotent +**Tags**: line-chart, plot, visualization -**Parameters**: -- `file_path` (str): Parameter for file_path -- `x_column` (str): Parameter for x_column -- `y_column` (str): Parameter for y_column -- `title` (str, optional): Parameter for title (default: Line Plot) -- `output_path` (str, optional): Parameter for output_path (default: line_plot.png) +### `bar_plot` +**Description**: Create a bar chart from CSV or Excel data with categorical grouping. +**Hints**: destructive, idempotent +**Tags**: bar-chart, plot, visualization -**Returns**: Dictionary containing: - plot_info: Details about the generated plot including dimensions and format - data_summary: Statistical summary of the plotted data - file_details: Information about the output file size and location - visualization_stats: Metrics about data points and trends +### `scatter_plot` +**Description**: Create a scatter plot from CSV or Excel data for correlation analysis. +**Hints**: destructive, idempotent +**Tags**: plot, scatter-plot, visualization -### `bar_plot` -**Description**: Create a bar plot from data file with comprehensive customization options. +### `histogram_plot` +**Description**: Create a histogram from CSV or Excel data showing value distribution. +**Hints**: destructive, idempotent +**Tags**: histogram, plot, visualization -**Parameters**: -- `file_path` (str): Parameter for file_path -- `x_column` (str): Parameter for x_column -- `y_column` (str): Parameter for y_column -- `title` (str, optional): Parameter for title (default: Bar Plot) -- `output_path` (str, optional): Parameter for output_path (default: bar_plot.png) +### `heatmap_plot` +**Description**: Create a correlation heatmap from numeric columns in CSV or Excel data. +**Hints**: destructive, idempotent +**Tags**: heatmap, plot, visualization -**Returns**: Dictionary containing: - plot_info: Details about the generated bar chart including bar count and styling - data_summary: Statistical summary of the categorical and numerical data - file_details: Information about the output file size and location - visualization_stats: Metrics about data distribution and categories +### `data_info` +**Description**: Get schema, column types, and summary statistics for a CSV or Excel file. +**Hints**: read-only, idempotent +**Tags**: analysis, data, visualization -### `scatter_plot` -**Description**: Create a scatter plot from data file with advanced correlation analysis. +### Resources -**Parameters**: -- `file_path` (str): Parameter for file_path -- `x_column` (str): Parameter for x_column -- `y_column` (str): Parameter for y_column -- `title` (str, optional): Parameter for title (default: Scatter Plot) -- `output_path` (str, optional): Parameter for output_path (default: scatter_plot.png) +- `plot://styles` - Available matplotlib plot styles and color palettes. -**Returns**: Dictionary containing: - plot_info: Details about the generated scatter plot including point count and styling - correlation_stats: Statistical correlation metrics and trend analysis - data_summary: Statistical summary of both x and y variables - file_details: Information about the output file size and location +### Prompts -### `histogram_plot` -**Description**: Create a histogram from data file with advanced statistical analysis. +- **create_visualization**: Guided workflow for creating a data visualization. +## Claude Code -**Parameters**: -- `file_path` (str): Parameter for file_path -- `column` (str): Parameter for column -- `bins` (int, optional): Parameter for bins (default: 30) -- `title` (str, optional): Parameter for title (default: Histogram) -- `output_path` (str, optional): Parameter for output_path (default: histogram.png) +```bash +claude mcp add clio-plot -- uvx clio-kit plot +``` -**Returns**: Dictionary containing: - plot_info: Details about the generated histogram including bin information - distribution_stats: Statistical metrics including mean, median, mode, and standard deviation - data_summary: Comprehensive summary of the data distribution - file_details: Information about the output file size and location +Or install via the CLIO Kit plugin marketplace: -### `heatmap_plot` -**Description**: Create a heatmap from data file with advanced correlation visualization. +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-plot@iowarp-clio-kit +``` +## Claude Desktop -**Parameters**: -- `file_path` (str): Parameter for file_path -- `title` (str, optional): Parameter for title (default: Heatmap) -- `output_path` (str, optional): Parameter for output_path (default: heatmap.png) +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Returns**: Dictionary containing: - plot_info: Details about the generated heatmap including matrix dimensions - correlation_matrix: Full correlation matrix with statistical significance - data_summary: Statistical summary of all numerical variables - file_details: Information about the output file size and location +```json +{ + "mcpServers": { + "clio-plot": { + "command": "uvx", + "args": [ + "clio-kit", + "plot" + ] + } + } +} +``` +## Gemini CLI -### `data_info` -**Description**: Get comprehensive data file information with detailed analysis. +Add to `~/.gemini/settings.json`: + +```json +{ + "mcpServers": { + "clio-plot": { + "command": "uvx", + "args": [ + "clio-kit", + "plot" + ] + } + } +} +``` -**Parameters**: -- `file_path` (str): Parameter for file_path +Or install the CLIO Kit extension: -**Returns**: Dictionary containing: - data_schema: Column names, data types, and null value analysis - data_quality: Missing values, duplicates, and data consistency metrics - statistical_summary: Basic statistics for numerical and categorical columns - visualization_recommendations: Suggested plot types based on data characteristics +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Data Exploration and Analysis diff --git a/clio-kit-mcp-servers/plot/pyproject.toml b/clio-kit-mcp-servers/plot/pyproject.toml index c0c5bb4b..2e6f59d7 100644 --- a/clio-kit-mcp-servers/plot/pyproject.toml +++ b/clio-kit-mcp-servers/plot/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["MCP", "plotting", "visualization", "analytics", "matplotlib", "seaborn", "data-science"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "python-dotenv>=1.0.0", "pandas>=1.5.0", "matplotlib>=3.6.0", @@ -26,7 +26,7 @@ Homepage = "https://toolkit.iowarp.ai/" Repository = "https://github.com/iowarp/clio-kit" [project.scripts] -plot-mcp = "server:main" +plot-mcp = "plot_mcp.server:main" [dependency-groups] dev = [ @@ -39,5 +39,13 @@ dev = [ [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/plot_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/plot/server.json b/clio-kit-mcp-servers/plot/server.json new file mode 100644 index 00000000..e43fd8ed --- /dev/null +++ b/clio-kit-mcp-servers/plot/server.json @@ -0,0 +1,59 @@ +{ + "name": "io.github.iowarp/plot-mcp", + "description": "MCP server for advanced data visualization and plotting operations", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "plot" + ] + }, + "tools": [ + { + "name": "line_plot", + "description": "Create a line plot from CSV or Excel data with customizable styling." + }, + { + "name": "bar_plot", + "description": "Create a bar chart from CSV or Excel data with categorical grouping." + }, + { + "name": "scatter_plot", + "description": "Create a scatter plot from CSV or Excel data for correlation analysis." + }, + { + "name": "histogram_plot", + "description": "Create a histogram from CSV or Excel data showing value distribution." + }, + { + "name": "heatmap_plot", + "description": "Create a correlation heatmap from numeric columns in CSV or Excel data." + }, + { + "name": "data_info", + "description": "Get schema, column types, and summary statistics for a CSV or Excel file." + } + ], + "resources": [ + { + "uri": "plot://styles", + "name": "available_styles", + "description": "Available matplotlib plot styles and color palettes." + } + ], + "prompts": [ + { + "name": "create_visualization", + "description": "Guided workflow for creating a data visualization." + } + ], + "tags": [ + "data-visualization", + "matplotlib", + "plotting", + "charts" + ] +} diff --git a/clio-kit-mcp-servers/plot/src/__init__.py b/clio-kit-mcp-servers/plot/src/__init__.py deleted file mode 100644 index 2270bb5e..00000000 --- a/clio-kit-mcp-servers/plot/src/__init__.py +++ /dev/null @@ -1,6 +0,0 @@ -""" -Plot MCP Server Package -""" - -__version__ = "0.1.0" -__author__ = "IoWarp Scientific MCPs" diff --git a/clio-kit-mcp-servers/plot/src/plot_mcp/__init__.py b/clio-kit-mcp-servers/plot/src/plot_mcp/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/clio-kit-mcp-servers/plot/src/implementation/__init__.py b/clio-kit-mcp-servers/plot/src/plot_mcp/implementation/__init__.py similarity index 100% rename from clio-kit-mcp-servers/plot/src/implementation/__init__.py rename to clio-kit-mcp-servers/plot/src/plot_mcp/implementation/__init__.py diff --git a/clio-kit-mcp-servers/plot/src/implementation/plot_capabilities.py b/clio-kit-mcp-servers/plot/src/plot_mcp/implementation/plot_capabilities.py similarity index 100% rename from clio-kit-mcp-servers/plot/src/implementation/plot_capabilities.py rename to clio-kit-mcp-servers/plot/src/plot_mcp/implementation/plot_capabilities.py diff --git a/clio-kit-mcp-servers/plot/src/server.py b/clio-kit-mcp-servers/plot/src/plot_mcp/server.py similarity index 61% rename from clio-kit-mcp-servers/plot/src/server.py rename to clio-kit-mcp-servers/plot/src/plot_mcp/server.py index 72c0ef02..441b05fe 100644 --- a/clio-kit-mcp-servers/plot/src/server.py +++ b/clio-kit-mcp-servers/plot/src/plot_mcp/server.py @@ -6,13 +6,12 @@ """ import os -import sys -import json -import argparse from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message from dotenv import load_dotenv import logging -from implementation.plot_capabilities import ( +from .implementation.plot_capabilities import ( create_line_plot, create_bar_plot, create_scatter_plot, @@ -27,19 +26,29 @@ ) logger = logging.getLogger(__name__) -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - # Load environment variables load_dotenv() # Initialize MCP server -mcp: FastMCP = FastMCP("PlotServer") +mcp: FastMCP = FastMCP( + "plot", + instructions=( + "Creates data visualizations using matplotlib. " + "Generate line plots, bar charts, scatter plots, histograms, and heatmaps from data. " + "All plots are saved to files." + ), +) @mcp.tool( name="line_plot", - description="Create line plots from CSV or Excel data with customizable styling and formatting. Supports multiple data series, trend analysis, and time-series visualization with advanced customization options.", + description="Create a line plot from CSV or Excel data with customizable styling.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"plot", "line-chart", "visualization"}, ) async def line_plot_tool( file_path: str, @@ -66,12 +75,21 @@ async def line_plot_tool( - visualization_stats: Metrics about data points and trends """ logger.info(f"Creating line plot from {file_path}") - return create_line_plot(file_path, x_column, y_column, title, output_path) + result = create_line_plot(file_path, x_column, y_column, title, output_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result @mcp.tool( name="bar_plot", - description="Create bar charts from CSV or Excel data with advanced styling and categorical data visualization. Supports grouped bars, stacked bars, and horizontal orientation with customizable colors and annotations.", + description="Create a bar chart from CSV or Excel data with categorical grouping.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"plot", "bar-chart", "visualization"}, ) async def bar_plot_tool( file_path: str, @@ -98,12 +116,21 @@ async def bar_plot_tool( - visualization_stats: Metrics about data distribution and categories """ logger.info(f"Creating bar plot from {file_path}") - return create_bar_plot(file_path, x_column, y_column, title, output_path) + result = create_bar_plot(file_path, x_column, y_column, title, output_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result @mcp.tool( name="scatter_plot", - description="Create scatter plots from CSV or Excel data with correlation analysis and trend visualization. Supports multi-dimensional data exploration, regression lines, and statistical annotations for data relationships.", + description="Create a scatter plot from CSV or Excel data for correlation analysis.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"plot", "scatter-plot", "visualization"}, ) async def scatter_plot_tool( file_path: str, @@ -130,12 +157,21 @@ async def scatter_plot_tool( - file_details: Information about the output file size and location """ logger.info(f"Creating scatter plot from {file_path}") - return create_scatter_plot(file_path, x_column, y_column, title, output_path) + result = create_scatter_plot(file_path, x_column, y_column, title, output_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result @mcp.tool( name="histogram_plot", - description="Create histograms from CSV or Excel data with statistical distribution analysis. Supports density plots, normal distribution overlays, and comprehensive statistical metrics for data distribution visualization.", + description="Create a histogram from CSV or Excel data showing value distribution.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"plot", "histogram", "visualization"}, ) async def histogram_plot_tool( file_path: str, @@ -162,12 +198,21 @@ async def histogram_plot_tool( - file_details: Information about the output file size and location """ logger.info(f"Creating histogram from {file_path}") - return create_histogram(file_path, column, bins, title, output_path) + result = create_histogram(file_path, column, bins, title, output_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result @mcp.tool( name="heatmap_plot", - description="Create heatmaps from CSV or Excel data with correlation matrix analysis and color-coded data visualization. Supports hierarchical clustering, dendrograms, and advanced color mapping for multi-dimensional data exploration.", + description="Create a correlation heatmap from numeric columns in CSV or Excel data.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"plot", "heatmap", "visualization"}, ) async def heatmap_plot_tool( file_path: str, title: str = "Heatmap", output_path: str = "heatmap.png" @@ -188,12 +233,21 @@ async def heatmap_plot_tool( - file_details: Information about the output file size and location """ logger.info(f"Creating heatmap from {file_path}") - return create_heatmap(file_path, title, output_path) + result = create_heatmap(file_path, title, output_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result @mcp.tool( name="data_info", - description="Get comprehensive data file information including detailed schema analysis, data quality assessment, and statistical profiling. Provides thorough data exploration with column types, distributions, and data health metrics.", + description="Get schema, column types, and summary statistics for a CSV or Excel file.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"data", "analysis", "visualization"}, ) async def data_info_tool(file_path: str) -> dict: """ @@ -210,64 +264,51 @@ async def data_info_tool(file_path: str) -> dict: - visualization_recommendations: Suggested plot types based on data characteristics """ logger.info(f"Getting data info for {file_path}") - return get_data_info(file_path) - - -def main(): - """ - Main entry point for the Plot MCP server. - Supports both stdio and SSE transports based on environment variables. - """ - # Handle 'help' command (without dashes) by converting to --help - if len(sys.argv) > 1 and sys.argv[1] == "help": - sys.argv[1] = "--help" - - parser = argparse.ArgumentParser( - description="Plot MCP Server - Data visualization server with comprehensive plotting capabilities", - prog="plot-mcp", - ) - parser.add_argument("--version", action="version", version="Plot MCP Server v1.0.0") - parser.add_argument( - "--transport", - choices=["stdio", "sse"], - default="stdio", - help="Transport type to use (default: stdio)", - ) - parser.add_argument( - "--host", default="0.0.0.0", help="Host for SSE transport (default: 0.0.0.0)" - ) - parser.add_argument( - "--port", type=int, default=8000, help="Port for SSE transport (default: 8000)" - ) - + result = get_data_info(file_path) + if result.get("status") == "error": + raise ToolError(result["error"]) + return result + + +@mcp.resource("plot://styles") +def available_styles() -> dict: + """Available matplotlib plot styles and color palettes.""" + import matplotlib.pyplot as plt + + return { + "styles": plt.style.available, + "default_format": "png", + "supported_formats": ["png", "svg", "pdf", "jpg"], + } + + +@mcp.prompt() +def create_visualization(data_description: str) -> list[Message]: + """Guided workflow for creating a data visualization.""" + return [ + Message( + f"I need to visualize the following data: {data_description}. " + "Suggest the best chart type, create the plot with appropriate labels and styling, " + "and save it to a file." + ), + ] + + +def main() -> None: + """Main entry point for the Plot MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Plot MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) - try: - logger.info("Starting Plot MCP Server") - - # Use command-line args or environment variables - transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio").lower() - - if transport == "sse": - # SSE transport for web-based clients - host = args.host or os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = args.port or int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - json.dumps({"message": f"Starting SSE on {host}:{port}"}), - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # Default stdio transport - logger.info("Starting stdio transport") - print(json.dumps({"message": "Starting stdio transport"}), file=sys.stderr) - mcp.run(transport="stdio") - - except Exception as e: - logger.error(f"Server error: {e}") - print(json.dumps({"error": str(e)}), file=sys.stderr) - sys.exit(1) + else: + mcp.run(transport=transport) if __name__ == "__main__": diff --git a/clio-kit-mcp-servers/plot/tests/test_capabilities.py b/clio-kit-mcp-servers/plot/tests/test_capabilities.py index 22f1d684..865b33eb 100644 --- a/clio-kit-mcp-servers/plot/tests/test_capabilities.py +++ b/clio-kit-mcp-servers/plot/tests/test_capabilities.py @@ -6,7 +6,6 @@ """ import os -import sys import tempfile import pandas as pd import pytest @@ -14,10 +13,7 @@ matplotlib.use("Agg") -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from implementation.plot_capabilities import ( +from plot_mcp.implementation.plot_capabilities import ( load_data, create_line_plot, create_bar_plot, diff --git a/clio-kit-mcp-servers/plot/tests/test_complete.py b/clio-kit-mcp-servers/plot/tests/test_complete.py index 7a6d79b2..fd74d7a7 100644 --- a/clio-kit-mcp-servers/plot/tests/test_complete.py +++ b/clio-kit-mcp-servers/plot/tests/test_complete.py @@ -3,17 +3,13 @@ """ import os -import sys import tempfile import pandas as pd import pytest import time import threading -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from implementation.plot_capabilities import ( +from plot_mcp.implementation.plot_capabilities import ( create_line_plot, create_bar_plot, create_scatter_plot, @@ -416,17 +412,21 @@ def test_error_recovery_comprehensive(self): os.unlink(f.name) - # Test 2: File permissions (if possible) + # Test 2: Invalid input file for line plot test_data = pd.DataFrame({"x": [1, 2, 3], "y": [4, 5, 6]}) with tempfile.NamedTemporaryFile(mode="w", suffix=".csv", delete=False) as f: test_data.to_csv(f.name, index=False) - # Try to create output in non-existent directory + # Try to plot with a column that doesn't exist result = create_line_plot( - f.name, "x", "y", "Test", "/nonexistent/path/output.png" + f.name, "x", "nonexistent_col", "Test", "temp_error_test.png" ) assert result["status"] == "error" + # Cleanup + if os.path.exists("temp_error_test.png"): + os.unlink("temp_error_test.png") + os.unlink(f.name) # Test 3: Invalid plot parameters @@ -434,8 +434,10 @@ def test_error_recovery_comprehensive(self): with tempfile.NamedTemporaryFile(mode="w", suffix=".csv", delete=False) as f: test_data.to_csv(f.name, index=False) - # Invalid bin count for histogram - result = create_histogram(f.name, "x", -5, "Test", "temp_hist.png") + # Invalid column for histogram + result = create_histogram( + f.name, "nonexistent_col", 10, "Test", "temp_hist.png" + ) assert result["status"] == "error" # Invalid column types for heatmap diff --git a/clio-kit-mcp-servers/plot/tests/test_handlers.py b/clio-kit-mcp-servers/plot/tests/test_handlers.py index a808a12c..050822ca 100644 --- a/clio-kit-mcp-servers/plot/tests/test_handlers.py +++ b/clio-kit-mcp-servers/plot/tests/test_handlers.py @@ -1,22 +1,15 @@ """ -Comprehensive test coverage for handler f result = get_data_info(sample_csv_file) - assert result["status"] == "success" - assert result["shape"][0] == 5 # rows - assert len(result["columns"]) == 3ions and MCP tool handlers. +Comprehensive test coverage for handler functions and MCP tool handlers. """ import os -import sys import tempfile import pandas as pd import pytest import asyncio -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server # noqa: E402 -from implementation.plot_capabilities import ( +from plot_mcp import server +from plot_mcp.implementation.plot_capabilities import ( create_line_plot, create_bar_plot, create_scatter_plot, @@ -187,13 +180,13 @@ def test_handler_error_handling(self): async def test_mcp_tool_handlers_direct(self, sample_csv_file): """Test MCP tool handlers directly""" # Test data_info_tool - result = await server.data_info_tool.fn(file_path=sample_csv_file) + result = await server.data_info_tool(file_path=sample_csv_file) assert isinstance(result, dict) assert "status" in result # Test line_plot_tool with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.line_plot_tool.fn( + result = await server.line_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", @@ -205,7 +198,7 @@ async def test_mcp_tool_handlers_direct(self, sample_csv_file): # Test bar_plot_tool with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.bar_plot_tool.fn( + result = await server.bar_plot_tool( file_path=sample_csv_file, x_column="category", y_column="value", @@ -217,7 +210,7 @@ async def test_mcp_tool_handlers_direct(self, sample_csv_file): # Test scatter_plot_tool with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.scatter_plot_tool.fn( + result = await server.scatter_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", @@ -229,7 +222,7 @@ async def test_mcp_tool_handlers_direct(self, sample_csv_file): # Test histogram_plot_tool with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.histogram_plot_tool.fn( + result = await server.histogram_plot_tool( file_path=sample_csv_file, column="value", bins=10, @@ -241,7 +234,7 @@ async def test_mcp_tool_handlers_direct(self, sample_csv_file): # Test heatmap_plot_tool with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.heatmap_plot_tool.fn( + result = await server.heatmap_plot_tool( file_path=sample_csv_file, title="MCP Heatmap", output_path=f.name ) assert isinstance(result, dict) @@ -376,7 +369,7 @@ async def test_async_handler_comprehensive(self, sample_csv_file): """Test comprehensive async handler functionality""" # Test all async handlers in sequence async_tests = [ - server.data_info_tool.fn(file_path=sample_csv_file), + server.data_info_tool(file_path=sample_csv_file), ] # Add plot tests with temporary files @@ -389,35 +382,35 @@ async def test_async_handler_comprehensive(self, sample_csv_file): ): async_tests.extend( [ - server.line_plot_tool.fn( + server.line_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", title="Async Line", output_path=f1.name, ), - server.bar_plot_tool.fn( + server.bar_plot_tool( file_path=sample_csv_file, x_column="category", y_column="value", title="Async Bar", output_path=f2.name, ), - server.scatter_plot_tool.fn( + server.scatter_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", title="Async Scatter", output_path=f3.name, ), - server.histogram_plot_tool.fn( + server.histogram_plot_tool( file_path=sample_csv_file, column="value", bins=10, title="Async Histogram", output_path=f4.name, ), - server.heatmap_plot_tool.fn( + server.heatmap_plot_tool( file_path=sample_csv_file, title="Async Heatmap", output_path=f5.name, diff --git a/clio-kit-mcp-servers/plot/tests/test_integration.py b/clio-kit-mcp-servers/plot/tests/test_integration.py index 4fad9d8b..377a56e3 100644 --- a/clio-kit-mcp-servers/plot/tests/test_integration.py +++ b/clio-kit-mcp-servers/plot/tests/test_integration.py @@ -3,16 +3,12 @@ """ import os -import sys import tempfile import pandas as pd import pytest import time -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -from implementation.plot_capabilities import ( +from plot_mcp.implementation.plot_capabilities import ( load_data, create_line_plot, create_bar_plot, diff --git a/clio-kit-mcp-servers/plot/tests/test_server.py b/clio-kit-mcp-servers/plot/tests/test_server.py index 3a6d8c01..ce0cbb8a 100644 --- a/clio-kit-mcp-servers/plot/tests/test_server.py +++ b/clio-kit-mcp-servers/plot/tests/test_server.py @@ -3,17 +3,12 @@ """ import os -import sys -import subprocess import tempfile import pandas as pd import pytest -import asyncio -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -import server # noqa: E402 +from fastmcp.exceptions import ToolError +from plot_mcp import server class TestServer: @@ -39,11 +34,13 @@ def test_mcp_server_initialization(self): """Test that MCP server is properly initialized""" assert hasattr(server, "mcp") assert server.mcp is not None - assert server.mcp.name == "PlotServer" + assert server.mcp.name == "plot" def test_server_module_imports(self): """Test that server module imports work correctly""" assert hasattr(server, "FastMCP") + assert hasattr(server, "ToolError") + assert hasattr(server, "Message") assert hasattr(server, "create_histogram") assert hasattr(server, "create_heatmap") assert hasattr(server, "create_line_plot") @@ -66,21 +63,21 @@ def test_all_tools_registered(self): assert hasattr(server, tool_name), f"Missing tool function: {tool_name}" tool = getattr(server, tool_name) assert tool is not None - assert hasattr(tool, "name") + assert callable(tool) def test_main_function_exists(self): """Test that main function exists and is callable""" assert hasattr(server, "main") assert callable(server.main) - def test_argument_parsing_sse_transport(self): - """Test argument parsing for SSE transport""" + def test_argument_parsing_http_transport(self): + """Test argument parsing for HTTP transport""" import argparse test_args = [ "server.py", "--transport", - "sse", + "http", "--host", "localhost", "--port", @@ -88,12 +85,12 @@ def test_argument_parsing_sse_transport(self): ] parser = argparse.ArgumentParser(description="Plot MCP Server") - parser.add_argument("--transport", choices=["stdio", "sse"], default="stdio") - parser.add_argument("--host", default="localhost") - parser.add_argument("--port", type=int, default=8080) + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) args = parser.parse_args(test_args[1:]) - assert args.transport == "sse" + assert args.transport == "http" assert args.host == "localhost" assert args.port == 8080 @@ -104,128 +101,19 @@ def test_argument_parsing_stdio_transport(self): test_args = ["server.py"] parser = argparse.ArgumentParser(description="Plot MCP Server") - parser.add_argument("--transport", choices=["stdio", "sse"], default="stdio") - parser.add_argument("--host", default="localhost") - parser.add_argument("--port", type=int, default=8080) + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) args = parser.parse_args(test_args[1:]) - assert args.transport == "stdio" - assert args.host == "localhost" - assert args.port == 8080 - - def test_server_help_output(self): - """Test that server provides help output""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - result = subprocess.run( - [sys.executable, script_path, "--help"], - capture_output=True, - text=True, - timeout=5, # Reduced timeout for GitHub Actions - ) - - assert result.returncode == 0 - assert "--transport" in result.stdout - assert "--host" in result.stdout - assert "--port" in result.stdout - - def test_main_function_comprehensive_scenarios(self): - """Test main function with various argument scenarios""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - # Test "help" command conversion to "--help" - result = subprocess.run( - [sys.executable, script_path, "help"], - capture_output=True, - text=True, - timeout=5, # Reduced timeout for GitHub Actions - ) - assert result.returncode == 0 - assert "--transport" in result.stdout - - # Test --version flag - result = subprocess.run( - [sys.executable, script_path, "--version"], - capture_output=True, - text=True, - timeout=5, # Reduced timeout for GitHub Actions - ) - assert result.returncode == 0 - assert "Plot MCP Server v1.0.0" in result.stdout - - def test_main_function_sse_transport_execution(self): - """Test main function SSE transport path""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - try: - subprocess.run( - [ - sys.executable, - script_path, - "--transport", - "sse", - "--host", - "127.0.0.1", - "--port", - "9998", - ], - capture_output=True, - text=True, - timeout=2, # Reduced timeout for GitHub Actions - ) - except subprocess.TimeoutExpired: - pass # Expected - server would start and run - - def test_main_function_environment_variables(self): - """Test main function with environment variables""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - env = os.environ.copy() - env["MCP_TRANSPORT"] = "stdio" - env["MCP_SSE_HOST"] = "localhost" - env["MCP_SSE_PORT"] = "8002" - - try: - subprocess.run( - [sys.executable, script_path], - capture_output=True, - text=True, - timeout=2, - env=env, - ) - except subprocess.TimeoutExpired: - pass # Expected for stdio transport - - def test_main_function_error_scenarios(self): - """Test main function error handling paths""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - try: - result = subprocess.run( - [sys.executable, script_path, "--invalid-argument"], - capture_output=True, - text=True, - timeout=5, # Increased timeout for GitHub Actions - ) - - # Should exit with error code - assert result.returncode != 0 - assert ( - "unrecognized arguments" in result.stderr.lower() - or "error" in result.stderr.lower() - or "invalid" in result.stderr.lower() - ) - except subprocess.TimeoutExpired: - # If it times out, that means argument parsing might not be reached - # This is acceptable as the server is designed for long-running processes - pytest.skip( - "Server hangs with invalid arguments - expected behavior for MCP servers" - ) + assert args.transport is None + assert args.host == "0.0.0.0" + assert args.port == 8000 @pytest.mark.asyncio async def test_data_info_tool_execution(self, sample_csv_file): """Test data_info_tool execution""" - result = await server.data_info_tool.fn(file_path=sample_csv_file) + result = await server.data_info_tool(file_path=sample_csv_file) assert isinstance(result, dict) assert "status" in result @@ -233,7 +121,7 @@ async def test_data_info_tool_execution(self, sample_csv_file): async def test_line_plot_tool_execution(self, sample_csv_file): """Test line_plot_tool execution""" with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.line_plot_tool.fn( + result = await server.line_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", @@ -248,7 +136,7 @@ async def test_line_plot_tool_execution(self, sample_csv_file): async def test_bar_plot_tool_execution(self, sample_csv_file): """Test bar_plot_tool execution""" with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.bar_plot_tool.fn( + result = await server.bar_plot_tool( file_path=sample_csv_file, x_column="category", y_column="value", @@ -263,7 +151,7 @@ async def test_bar_plot_tool_execution(self, sample_csv_file): async def test_scatter_plot_tool_execution(self, sample_csv_file): """Test scatter_plot_tool execution""" with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.scatter_plot_tool.fn( + result = await server.scatter_plot_tool( file_path=sample_csv_file, x_column="x", y_column="y", @@ -278,7 +166,7 @@ async def test_scatter_plot_tool_execution(self, sample_csv_file): async def test_histogram_plot_tool_execution(self, sample_csv_file): """Test histogram_plot_tool execution""" with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.histogram_plot_tool.fn( + result = await server.histogram_plot_tool( file_path=sample_csv_file, column="value", bins=10, @@ -293,133 +181,43 @@ async def test_histogram_plot_tool_execution(self, sample_csv_file): async def test_heatmap_plot_tool_execution(self, sample_csv_file): """Test heatmap_plot_tool execution""" with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f: - result = await server.heatmap_plot_tool.fn( + result = await server.heatmap_plot_tool( file_path=sample_csv_file, title="Test Heatmap", output_path=f.name ) assert isinstance(result, dict) assert "status" in result os.unlink(f.name) - def test_server_script_execution_stdio(self): - """Test server script execution with stdio transport""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - process = subprocess.Popen( - [sys.executable, script_path, "--transport", "stdio"], - stdin=subprocess.PIPE, - stdout=subprocess.PIPE, - stderr=subprocess.PIPE, - text=True, - ) - - try: - stdout, stderr = process.communicate(timeout=2) - assert process.returncode is not None - except subprocess.TimeoutExpired: - process.terminate() - try: - process.wait(timeout=2) - except subprocess.TimeoutExpired: - process.kill() - process.wait() - assert True # Expected - stdio transport started - - def test_server_script_execution_sse(self): - """Test server script execution with SSE transport""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - process = subprocess.Popen( - [ - sys.executable, - script_path, - "--transport", - "sse", - "--host", - "127.0.0.1", - "--port", - "9999", - ], - stdout=subprocess.PIPE, - stderr=subprocess.PIPE, - text=True, - ) - - try: - stdout, stderr = process.communicate(timeout=2) # Reduced timeout - assert process.returncode is not None - except subprocess.TimeoutExpired: - process.terminate() - try: - process.wait(timeout=2) - except subprocess.TimeoutExpired: - process.kill() - process.wait() - assert True # Expected - SSE server started - - def test_environment_variable_handling(self): - """Test environment variable handling""" - script_path = os.path.join(os.path.dirname(__file__), "..", "src", "server.py") - - env = os.environ.copy() - env["MCP_TRANSPORT"] = "stdio" - - process = subprocess.Popen( - [sys.executable, script_path], - stdin=subprocess.PIPE, - stdout=subprocess.PIPE, - stderr=subprocess.PIPE, - text=True, - env=env, - ) - - try: - stdout, stderr = process.communicate(timeout=2) - except subprocess.TimeoutExpired: - process.terminate() - try: - process.wait(timeout=2) - except subprocess.TimeoutExpired: - process.kill() - process.wait() - # This is success - environment variables were used - - def test_tool_error_handling(self, sample_csv_file): + @pytest.mark.asyncio + async def test_tool_error_handling(self, sample_csv_file): """Test tool error handling scenarios""" - # Test with invalid file path - async def test_invalid_file(): - result = await server.data_info_tool.fn(file_path="/nonexistent/file.csv") - assert result["status"] == "error" - - asyncio.run(test_invalid_file()) + with pytest.raises(ToolError): + await server.data_info_tool(file_path="/nonexistent/file.csv") # Test with invalid column - async def test_invalid_column(): - result = await server.line_plot_tool.fn( + with pytest.raises(ToolError): + await server.line_plot_tool( file_path=sample_csv_file, x_column="invalid_column", y_column="y", title="Test", output_path="output.png", ) - assert result["status"] == "error" - - asyncio.run(test_invalid_column()) def test_server_module_structure(self): """Test server module has expected structure""" assert hasattr(server, "FastMCP") assert hasattr(server, "mcp") - # Check that plot_capabilities is imported - import importlib.util + # Check that plot_capabilities is importable through the package + from plot_mcp.implementation import plot_capabilities - spec = importlib.util.find_spec("implementation.plot_capabilities") - assert spec is not None + assert plot_capabilities is not None def test_comprehensive_server_functionality(self, sample_csv_file): """Test comprehensive server functionality""" - # Test that all tools exist and have proper attributes + # Test that all tools exist and are callable tools = [ "line_plot_tool", "bar_plot_tool", @@ -433,8 +231,7 @@ def test_comprehensive_server_functionality(self, sample_csv_file): assert hasattr(server, tool_name) tool = getattr(server, tool_name) assert tool is not None - assert hasattr(tool, "name") - assert hasattr(tool, "fn") + assert callable(tool) def test_logger_configuration(self): """Test logger configuration""" @@ -445,19 +242,20 @@ def test_imports_and_dependencies(self): """Test imports and dependencies""" # Test that all required modules are imported assert hasattr(server, "os") - assert hasattr(server, "sys") - assert hasattr(server, "json") - assert hasattr(server, "argparse") assert hasattr(server, "FastMCP") assert hasattr(server, "logging") - def test_package_init_import(self): - """Test that package __init__.py can be imported and has expected attributes""" - # Import the package to get coverage on __init__.py - import src + def test_resource_registered(self): + """Test that the plot styles resource is registered""" + assert hasattr(server, "available_styles") + assert callable(server.available_styles) + + def test_prompt_registered(self): + """Test that the create_visualization prompt is registered""" + assert hasattr(server, "create_visualization") + assert callable(server.create_visualization) - # Check that the package has expected attributes - assert hasattr(src, "__version__") - assert hasattr(src, "__author__") - assert src.__version__ == "0.1.0" - assert src.__author__ == "IoWarp Scientific MCPs" + def test_server_has_instructions(self): + """Test that the MCP server has instructions set""" + assert server.mcp.instructions is not None + assert "matplotlib" in server.mcp.instructions diff --git a/clio-kit-mcp-servers/plot/uv.lock b/clio-kit-mcp-servers/plot/uv.lock index ddd599cc..e1013222 100644 --- a/clio-kit-mcp-servers/plot/uv.lock +++ b/clio-kit-mcp-servers/plot/uv.lock @@ -430,18 +430,19 @@ wheels = [ [[package]] name = "cyclopts" -version = "3.22.2" +version = "4.5.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "attrs" }, - { name = "docstring-parser", marker = "python_full_version < '4.0'" }, + { name = "docstring-parser" }, { name = "rich" }, { name = "rich-rst" }, + { name = "tomli", marker = "python_full_version < '3.11'" }, { name = "typing-extensions", marker = "python_full_version < '3.11'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/cc/2e/8c45ef5b00bd48d7cabbf6f90b7f12df4c232755cd46e6dbc6690f9ac0c5/cyclopts-3.22.2.tar.gz", hash = "sha256:d3495231af6ae86479579777d212ddf77b113200f828badeaf401162ed87227d", size = 74520, upload-time = "2025-07-09T12:21:46.866Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a5/16/06e35c217334930ff7c476ce1c8e74ed786fa3ef6742e59a1458e2412290/cyclopts-4.5.3.tar.gz", hash = "sha256:35fa70971204c450d9668646a6ca372eb5fa3070fbe8dd51c5b4b31e65198f2d", size = 162437, upload-time = "2026-02-16T15:07:11.96Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/83/5b/5939e05d87def1612c494429bee705d6b852fad1d21dd2dee1e3ce39997e/cyclopts-3.22.2-py3-none-any.whl", hash = "sha256:6681b0815fa2de2bccc364468fd25b15aa9617cb505c0b16ca62e2b18a57619e", size = 84578, upload-time = "2025-07-09T12:21:44.878Z" }, + { url = "https://files.pythonhosted.org/packages/3a/1f/d8bce383a90d8a6a11033327777afa4d4d611ec11869284adb6f48152906/cyclopts-4.5.3-py3-none-any.whl", hash = "sha256:50af3085bb15d4a6f2582dd383dad5e4ba6a0d4d4c64ee63326d881a752a6919", size = 200231, upload-time = "2026-02-16T15:07:13.045Z" }, ] [[package]] @@ -516,27 +517,33 @@ wheels = [ [[package]] name = "fastmcp" -version = "2.13.0.2" +version = "3.0.0rc2" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "authlib" }, { name = "cyclopts" }, { name = "exceptiongroup" }, { name = "httpx" }, + { name = "jsonref" }, { name = "jsonschema-path" }, { name = "mcp" }, { name = "openapi-pydantic" }, + { name = "opentelemetry-api" }, + { name = "packaging" }, { name = "platformdirs" }, { name = "py-key-value-aio", extra = ["disk", "keyring", "memory"] }, { name = "pydantic", extra = ["email"] }, { name = "pyperclip" }, { name = "python-dotenv" }, + { name = "pyyaml" }, { name = "rich" }, + { name = "uvicorn" }, + { name = "watchfiles" }, { name = "websockets" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/1b/74/584a152bcd174c99ddf3cfdd7e86ec4a6c696fb190a907c2a2ec9056bda2/fastmcp-2.13.0.2.tar.gz", hash = "sha256:d35386561b6f3cde195ba2b5892dc89b8919a721e6b39b98e7a16f9a7c0b8e8b", size = 7762083, upload-time = "2025-10-28T13:56:21.702Z" } +sdist = { url = "https://files.pythonhosted.org/packages/8b/3a/afa90e3646b754d52cd8a436490ffed38bc9fd0d605f479d04de38af1dee/fastmcp-3.0.0rc2.tar.gz", hash = "sha256:81cc408b13a0ab2e7701abaa04c8a64597e13bb2fec2a7fc92fd324e08855ef2", size = 14258553, upload-time = "2026-02-14T03:57:09.199Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/bd/c6/95eacd687cfab64fec13bfb64e6c6e7da13d01ecd4cb7d7e991858a08119/fastmcp-2.13.0.2-py3-none-any.whl", hash = "sha256:eb381eb073a101aabbc0ac44b05e23fef0cd1619344b7703115c825c8755fa1c", size = 367511, upload-time = "2025-10-28T13:56:18.83Z" }, + { url = "https://files.pythonhosted.org/packages/56/7b/556317e567956fb6108f981d63a48be69e5e0014ae745f4feb3f50a1da4e/fastmcp-3.0.0rc2-py3-none-any.whl", hash = "sha256:0596b372c4b6b193f02619a874dca3550b153b085827e82133ccfef2bb687a3d", size = 601390, upload-time = "2026-02-14T03:57:07.277Z" }, ] [[package]] @@ -640,7 +647,7 @@ name = "importlib-metadata" version = "8.7.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "zipp", marker = "python_full_version < '3.12'" }, + { name = "zipp" }, ] sdist = { url = "https://files.pythonhosted.org/packages/76/66/650a33bd90f786193e4de4b3ad86ea60b53c89b669a5c7be931fac31cdb0/importlib_metadata-8.7.0.tar.gz", hash = "sha256:d13b81ad223b890aa16c5471f2ac3056cf76c5f10f82d6f9292f0b415f389000", size = 56641, upload-time = "2025-04-27T15:29:01.736Z" } wheels = [ @@ -701,6 +708,15 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b2/a3/e137168c9c44d18eff0376253da9f1e9234d0239e0ee230d2fee6cea8e55/jeepney-0.9.0-py3-none-any.whl", hash = "sha256:97e5714520c16fc0a45695e5365a2e11b81ea79bba796e26f9f1d178cb182683", size = 49010, upload-time = "2025-02-27T18:51:00.104Z" }, ] +[[package]] +name = "jsonref" +version = "1.1.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/aa/0d/c1f3277e90ccdb50d33ed5ba1ec5b3f0a242ed8c1b1a85d3afeb68464dca/jsonref-1.1.0.tar.gz", hash = "sha256:32fe8e1d85af0fdefbebce950af85590b22b60f9e95443176adbde4e1ecea552", size = 8814, upload-time = "2023-01-16T16:10:04.455Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/ec/e1db9922bceb168197a558a2b8c03a7963f1afe93517ddd3cf99f202f996/jsonref-1.1.0-py3-none-any.whl", hash = "sha256:590dc7773df6c21cbf948b5dac07a72a251db28b0238ceecce0a2abfa8ec30a9", size = 9425, upload-time = "2023-01-16T16:10:02.255Z" }, +] + [[package]] name = "jsonschema" version = "4.24.0" @@ -914,7 +930,7 @@ wheels = [ [[package]] name = "mcp" -version = "1.21.0" +version = "1.26.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "anyio" }, @@ -928,11 +944,13 @@ dependencies = [ { name = "pywin32", marker = "sys_platform == 'win32'" }, { name = "sse-starlette" }, { name = "starlette" }, + { name = "typing-extensions" }, + { name = "typing-inspection" }, { name = "uvicorn", marker = "sys_platform != 'emscripten'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/33/54/dd2330ef4611c27ae59124820863c34e1d3edb1133c58e6375e2d938c9c5/mcp-1.21.0.tar.gz", hash = "sha256:bab0a38e8f8c48080d787233343f8d301b0e1e95846ae7dead251b2421d99855", size = 452697, upload-time = "2025-11-06T23:19:58.432Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/39/47/850b6edc96c03bd44b00de9a0ca3c1cc71e0ba1cd5822955bc9e4eb3fad3/mcp-1.21.0-py3-none-any.whl", hash = "sha256:598619e53eb0b7a6513db38c426b28a4bdf57496fed04332100d2c56acade98b", size = 173672, upload-time = "2025-11-06T23:19:56.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" }, ] [[package]] @@ -1057,6 +1075,19 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/c0/da/977ded879c29cbd04de313843e76868e6e13408a94ed6b987245dc7c8506/openpyxl-3.1.5-py2.py3-none-any.whl", hash = "sha256:5282c12b107bffeef825f4617dc029afaf41d0ea60823bbb665ef3079dc79de2", size = 250910, upload-time = "2024-06-28T14:03:41.161Z" }, ] +[[package]] +name = "opentelemetry-api" +version = "1.39.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "importlib-metadata" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/97/b9/3161be15bb8e3ad01be8be5a968a9237c3027c5be504362ff800fca3e442/opentelemetry_api-1.39.1.tar.gz", hash = "sha256:fbde8c80e1b937a2c61f20347e91c0c18a1940cecf012d62e65a7caf08967c9c", size = 65767, upload-time = "2025-12-11T13:32:39.182Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cf/df/d3f1ddf4bb4cb50ed9b1139cc7b1c54c34a1e7ce8fd1b9a37c0d1551a6bd/opentelemetry_api-1.39.1-py3-none-any.whl", hash = "sha256:2edd8463432a7f8443edce90972169b195e7d6a05500cd29e6d13898187c9950", size = 66356, upload-time = "2025-12-11T13:32:17.304Z" }, +] + [[package]] name = "packaging" version = "25.0" @@ -1277,7 +1308,7 @@ dev = [ [package.metadata] requires-dist = [ - { name = "fastmcp", specifier = ">=2.13.0" }, + { name = "fastmcp", specifier = ">=3.0.0rc2" }, { name = "matplotlib", specifier = ">=3.6.0" }, { name = "numpy", specifier = "<2.0.0" }, { name = "openpyxl", specifier = ">=3.0.0" }, @@ -1306,15 +1337,15 @@ wheels = [ [[package]] name = "py-key-value-aio" -version = "0.2.8" +version = "0.4.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "beartype" }, - { name = "py-key-value-shared" }, + { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/ca/35/65310a4818acec0f87a46e5565e341c5a96fc062a9a03495ad28828ff4d7/py_key_value_aio-0.2.8.tar.gz", hash = "sha256:c0cfbb0bd4e962a3fa1a9fa6db9ba9df812899bd9312fa6368aaea7b26008b36", size = 32853, upload-time = "2025-10-24T13:31:04.688Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/3c/0397c072a38d4bc580994b42e0c90c5f44f679303489e4376289534735e5/py_key_value_aio-0.4.4.tar.gz", hash = "sha256:e3012e6243ed7cc09bb05457bd4d03b1ba5c2b1ca8700096b3927db79ffbbe55", size = 92300, upload-time = "2026-02-16T21:21:43.245Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cd/5a/e56747d87a97ad2aff0f3700d77f186f0704c90c2da03bfed9e113dae284/py_key_value_aio-0.2.8-py3-none-any.whl", hash = "sha256:561565547ce8162128fd2bd0b9d70ce04a5f4586da8500cce79a54dfac78c46a", size = 69200, upload-time = "2025-10-24T13:31:03.81Z" }, + { url = "https://files.pythonhosted.org/packages/32/69/f1b537ee70b7def42d63124a539ed3026a11a3ffc3086947a1ca6e861868/py_key_value_aio-0.4.4-py3-none-any.whl", hash = "sha256:18e17564ecae61b987f909fc2cd41ee2012c84b4b1dcb8c055cf8b4bc1bf3f5d", size = 152291, upload-time = "2026-02-16T21:21:44.241Z" }, ] [package.optional-dependencies] @@ -1329,19 +1360,6 @@ memory = [ { name = "cachetools" }, ] -[[package]] -name = "py-key-value-shared" -version = "0.2.8" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "beartype" }, - { name = "typing-extensions" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/26/79/05a1f9280cfa0709479319cbfd2b1c5beb23d5034624f548c83fb65b0b61/py_key_value_shared-0.2.8.tar.gz", hash = "sha256:703b4d3c61af124f0d528ba85995c3c8d78f8bd3d2b217377bd3278598070cc1", size = 8216, upload-time = "2025-10-24T13:31:03.601Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/84/7a/1726ceaa3343874f322dd83c9ec376ad81f533df8422b8b1e1233a59f8ce/py_key_value_shared-0.2.8-py3-none-any.whl", hash = "sha256:aff1bbfd46d065b2d67897d298642e80e5349eae588c6d11b48452b46b8d46ba", size = 14586, upload-time = "2025-10-24T13:31:02.838Z" }, -] - [[package]] name = "pycparser" version = "2.22" @@ -2060,6 +2078,109 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/d2/e2/dc81b1bd1dcfe91735810265e9d26bc8ec5da45b4c0f6237e286819194c3/uvicorn-0.35.0-py3-none-any.whl", hash = "sha256:197535216b25ff9b785e29a0b79199f55222193d47f820816e7da751e9bc8d4a", size = 66406, upload-time = "2025-06-28T16:15:44.816Z" }, ] +[[package]] +name = "watchfiles" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "anyio" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c2/c9/8869df9b2a2d6c59d79220a4db37679e74f807c559ffe5265e08b227a210/watchfiles-1.1.1.tar.gz", hash = "sha256:a173cb5c16c4f40ab19cecf48a534c409f7ea983ab8fed0741304a1c0a31b3f2", size = 94440, upload-time = "2025-10-14T15:06:21.08Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/a7/1a/206e8cf2dd86fddf939165a57b4df61607a1e0add2785f170a3f616b7d9f/watchfiles-1.1.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:eef58232d32daf2ac67f42dea51a2c80f0d03379075d44a587051e63cc2e368c", size = 407318, upload-time = "2025-10-14T15:04:18.753Z" }, + { url = "https://files.pythonhosted.org/packages/b3/0f/abaf5262b9c496b5dad4ed3c0e799cbecb1f8ea512ecb6ddd46646a9fca3/watchfiles-1.1.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:03fa0f5237118a0c5e496185cafa92878568b652a2e9a9382a5151b1a0380a43", size = 394478, upload-time = "2025-10-14T15:04:20.297Z" }, + { url = "https://files.pythonhosted.org/packages/b1/04/9cc0ba88697b34b755371f5ace8d3a4d9a15719c07bdc7bd13d7d8c6a341/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8ca65483439f9c791897f7db49202301deb6e15fe9f8fe2fed555bf986d10c31", size = 449894, upload-time = "2025-10-14T15:04:21.527Z" }, + { url = "https://files.pythonhosted.org/packages/d2/9c/eda4615863cd8621e89aed4df680d8c3ec3da6a4cf1da113c17decd87c7f/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f0ab1c1af0cb38e3f598244c17919fb1a84d1629cc08355b0074b6d7f53138ac", size = 459065, upload-time = "2025-10-14T15:04:22.795Z" }, + { url = "https://files.pythonhosted.org/packages/84/13/f28b3f340157d03cbc8197629bc109d1098764abe1e60874622a0be5c112/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3bc570d6c01c206c46deb6e935a260be44f186a2f05179f52f7fcd2be086a94d", size = 488377, upload-time = "2025-10-14T15:04:24.138Z" }, + { url = "https://files.pythonhosted.org/packages/86/93/cfa597fa9389e122488f7ffdbd6db505b3b915ca7435ecd7542e855898c2/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e84087b432b6ac94778de547e08611266f1f8ffad28c0ee4c82e028b0fc5966d", size = 595837, upload-time = "2025-10-14T15:04:25.057Z" }, + { url = "https://files.pythonhosted.org/packages/57/1e/68c1ed5652b48d89fc24d6af905d88ee4f82fa8bc491e2666004e307ded1/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:620bae625f4cb18427b1bb1a2d9426dc0dd5a5ba74c7c2cdb9de405f7b129863", size = 473456, upload-time = "2025-10-14T15:04:26.497Z" }, + { url = "https://files.pythonhosted.org/packages/d5/dc/1a680b7458ffa3b14bb64878112aefc8f2e4f73c5af763cbf0bd43100658/watchfiles-1.1.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:544364b2b51a9b0c7000a4b4b02f90e9423d97fbbf7e06689236443ebcad81ab", size = 455614, upload-time = "2025-10-14T15:04:27.539Z" }, + { url = "https://files.pythonhosted.org/packages/61/a5/3d782a666512e01eaa6541a72ebac1d3aae191ff4a31274a66b8dd85760c/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:bbe1ef33d45bc71cf21364df962af171f96ecaeca06bd9e3d0b583efb12aec82", size = 630690, upload-time = "2025-10-14T15:04:28.495Z" }, + { url = "https://files.pythonhosted.org/packages/9b/73/bb5f38590e34687b2a9c47a244aa4dd50c56a825969c92c9c5fc7387cea1/watchfiles-1.1.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:1a0bb430adb19ef49389e1ad368450193a90038b5b752f4ac089ec6942c4dff4", size = 622459, upload-time = "2025-10-14T15:04:29.491Z" }, + { url = "https://files.pythonhosted.org/packages/f1/ac/c9bb0ec696e07a20bd58af5399aeadaef195fb2c73d26baf55180fe4a942/watchfiles-1.1.1-cp310-cp310-win32.whl", hash = "sha256:3f6d37644155fb5beca5378feb8c1708d5783145f2a0f1c4d5a061a210254844", size = 272663, upload-time = "2025-10-14T15:04:30.435Z" }, + { url = "https://files.pythonhosted.org/packages/11/a0/a60c5a7c2ec59fa062d9a9c61d02e3b6abd94d32aac2d8344c4bdd033326/watchfiles-1.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:a36d8efe0f290835fd0f33da35042a1bb5dc0e83cbc092dcf69bce442579e88e", size = 287453, upload-time = "2025-10-14T15:04:31.53Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f8/2c5f479fb531ce2f0564eda479faecf253d886b1ab3630a39b7bf7362d46/watchfiles-1.1.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:f57b396167a2565a4e8b5e56a5a1c537571733992b226f4f1197d79e94cf0ae5", size = 406529, upload-time = "2025-10-14T15:04:32.899Z" }, + { url = "https://files.pythonhosted.org/packages/fe/cd/f515660b1f32f65df671ddf6f85bfaca621aee177712874dc30a97397977/watchfiles-1.1.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:421e29339983e1bebc281fab40d812742268ad057db4aee8c4d2bce0af43b741", size = 394384, upload-time = "2025-10-14T15:04:33.761Z" }, + { url = "https://files.pythonhosted.org/packages/7b/c3/28b7dc99733eab43fca2d10f55c86e03bd6ab11ca31b802abac26b23d161/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6e43d39a741e972bab5d8100b5cdacf69db64e34eb19b6e9af162bccf63c5cc6", size = 448789, upload-time = "2025-10-14T15:04:34.679Z" }, + { url = "https://files.pythonhosted.org/packages/4a/24/33e71113b320030011c8e4316ccca04194bf0cbbaeee207f00cbc7d6b9f5/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f537afb3276d12814082a2e9b242bdcf416c2e8fd9f799a737990a1dbe906e5b", size = 460521, upload-time = "2025-10-14T15:04:35.963Z" }, + { url = "https://files.pythonhosted.org/packages/f4/c3/3c9a55f255aa57b91579ae9e98c88704955fa9dac3e5614fb378291155df/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b2cd9e04277e756a2e2d2543d65d1e2166d6fd4c9b183f8808634fda23f17b14", size = 488722, upload-time = "2025-10-14T15:04:37.091Z" }, + { url = "https://files.pythonhosted.org/packages/49/36/506447b73eb46c120169dc1717fe2eff07c234bb3232a7200b5f5bd816e9/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3f58818dc0b07f7d9aa7fe9eb1037aecb9700e63e1f6acfed13e9fef648f5d", size = 596088, upload-time = "2025-10-14T15:04:38.39Z" }, + { url = "https://files.pythonhosted.org/packages/82/ab/5f39e752a9838ec4d52e9b87c1e80f1ee3ccdbe92e183c15b6577ab9de16/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9bb9f66367023ae783551042d31b1d7fd422e8289eedd91f26754a66f44d5cff", size = 472923, upload-time = "2025-10-14T15:04:39.666Z" }, + { url = "https://files.pythonhosted.org/packages/af/b9/a419292f05e302dea372fa7e6fda5178a92998411f8581b9830d28fb9edb/watchfiles-1.1.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:aebfd0861a83e6c3d1110b78ad54704486555246e542be3e2bb94195eabb2606", size = 456080, upload-time = "2025-10-14T15:04:40.643Z" }, + { url = "https://files.pythonhosted.org/packages/b0/c3/d5932fd62bde1a30c36e10c409dc5d54506726f08cb3e1d8d0ba5e2bc8db/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:5fac835b4ab3c6487b5dbad78c4b3724e26bcc468e886f8ba8cc4306f68f6701", size = 629432, upload-time = "2025-10-14T15:04:41.789Z" }, + { url = "https://files.pythonhosted.org/packages/f7/77/16bddd9779fafb795f1a94319dc965209c5641db5bf1edbbccace6d1b3c0/watchfiles-1.1.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:399600947b170270e80134ac854e21b3ccdefa11a9529a3decc1327088180f10", size = 623046, upload-time = "2025-10-14T15:04:42.718Z" }, + { url = "https://files.pythonhosted.org/packages/46/ef/f2ecb9a0f342b4bfad13a2787155c6ee7ce792140eac63a34676a2feeef2/watchfiles-1.1.1-cp311-cp311-win32.whl", hash = "sha256:de6da501c883f58ad50db3a32ad397b09ad29865b5f26f64c24d3e3281685849", size = 271473, upload-time = "2025-10-14T15:04:43.624Z" }, + { url = "https://files.pythonhosted.org/packages/94/bc/f42d71125f19731ea435c3948cad148d31a64fccde3867e5ba4edee901f9/watchfiles-1.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:35c53bd62a0b885bf653ebf6b700d1bf05debb78ad9292cf2a942b23513dc4c4", size = 287598, upload-time = "2025-10-14T15:04:44.516Z" }, + { url = "https://files.pythonhosted.org/packages/57/c9/a30f897351f95bbbfb6abcadafbaca711ce1162f4db95fc908c98a9165f3/watchfiles-1.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:57ca5281a8b5e27593cb7d82c2ac927ad88a96ed406aa446f6344e4328208e9e", size = 277210, upload-time = "2025-10-14T15:04:45.883Z" }, + { url = "https://files.pythonhosted.org/packages/74/d5/f039e7e3c639d9b1d09b07ea412a6806d38123f0508e5f9b48a87b0a76cc/watchfiles-1.1.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:8c89f9f2f740a6b7dcc753140dd5e1ab9215966f7a3530d0c0705c83b401bd7d", size = 404745, upload-time = "2025-10-14T15:04:46.731Z" }, + { url = "https://files.pythonhosted.org/packages/a5/96/a881a13aa1349827490dab2d363c8039527060cfcc2c92cc6d13d1b1049e/watchfiles-1.1.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:bd404be08018c37350f0d6e34676bd1e2889990117a2b90070b3007f172d0610", size = 391769, upload-time = "2025-10-14T15:04:48.003Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5b/d3b460364aeb8da471c1989238ea0e56bec24b6042a68046adf3d9ddb01c/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8526e8f916bb5b9a0a777c8317c23ce65de259422bba5b31325a6fa6029d33af", size = 449374, upload-time = "2025-10-14T15:04:49.179Z" }, + { url = "https://files.pythonhosted.org/packages/b9/44/5769cb62d4ed055cb17417c0a109a92f007114a4e07f30812a73a4efdb11/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2edc3553362b1c38d9f06242416a5d8e9fe235c204a4072e988ce2e5bb1f69f6", size = 459485, upload-time = "2025-10-14T15:04:50.155Z" }, + { url = "https://files.pythonhosted.org/packages/19/0c/286b6301ded2eccd4ffd0041a1b726afda999926cf720aab63adb68a1e36/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:30f7da3fb3f2844259cba4720c3fc7138eb0f7b659c38f3bfa65084c7fc7abce", size = 488813, upload-time = "2025-10-14T15:04:51.059Z" }, + { url = "https://files.pythonhosted.org/packages/c7/2b/8530ed41112dd4a22f4dcfdb5ccf6a1baad1ff6eed8dc5a5f09e7e8c41c7/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8979280bdafff686ba5e4d8f97840f929a87ed9cdf133cbbd42f7766774d2aa", size = 594816, upload-time = "2025-10-14T15:04:52.031Z" }, + { url = "https://files.pythonhosted.org/packages/ce/d2/f5f9fb49489f184f18470d4f99f4e862a4b3e9ac2865688eb2099e3d837a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dcc5c24523771db3a294c77d94771abcfcb82a0e0ee8efd910c37c59ec1b31bb", size = 475186, upload-time = "2025-10-14T15:04:53.064Z" }, + { url = "https://files.pythonhosted.org/packages/cf/68/5707da262a119fb06fbe214d82dd1fe4a6f4af32d2d14de368d0349eb52a/watchfiles-1.1.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1db5d7ae38ff20153d542460752ff397fcf5c96090c1230803713cf3147a6803", size = 456812, upload-time = "2025-10-14T15:04:55.174Z" }, + { url = "https://files.pythonhosted.org/packages/66/ab/3cbb8756323e8f9b6f9acb9ef4ec26d42b2109bce830cc1f3468df20511d/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:28475ddbde92df1874b6c5c8aaeb24ad5be47a11f87cde5a28ef3835932e3e94", size = 630196, upload-time = "2025-10-14T15:04:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/78/46/7152ec29b8335f80167928944a94955015a345440f524d2dfe63fc2f437b/watchfiles-1.1.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:36193ed342f5b9842edd3532729a2ad55c4160ffcfa3700e0d54be496b70dd43", size = 622657, upload-time = "2025-10-14T15:04:57.521Z" }, + { url = "https://files.pythonhosted.org/packages/0a/bf/95895e78dd75efe9a7f31733607f384b42eb5feb54bd2eb6ed57cc2e94f4/watchfiles-1.1.1-cp312-cp312-win32.whl", hash = "sha256:859e43a1951717cc8de7f4c77674a6d389b106361585951d9e69572823f311d9", size = 272042, upload-time = "2025-10-14T15:04:59.046Z" }, + { url = "https://files.pythonhosted.org/packages/87/0a/90eb755f568de2688cb220171c4191df932232c20946966c27a59c400850/watchfiles-1.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:91d4c9a823a8c987cce8fa2690923b069966dabb196dd8d137ea2cede885fde9", size = 288410, upload-time = "2025-10-14T15:05:00.081Z" }, + { url = "https://files.pythonhosted.org/packages/36/76/f322701530586922fbd6723c4f91ace21364924822a8772c549483abed13/watchfiles-1.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:a625815d4a2bdca61953dbba5a39d60164451ef34c88d751f6c368c3ea73d404", size = 278209, upload-time = "2025-10-14T15:05:01.168Z" }, + { url = "https://files.pythonhosted.org/packages/bb/f4/f750b29225fe77139f7ae5de89d4949f5a99f934c65a1f1c0b248f26f747/watchfiles-1.1.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:130e4876309e8686a5e37dba7d5e9bc77e6ed908266996ca26572437a5271e18", size = 404321, upload-time = "2025-10-14T15:05:02.063Z" }, + { url = "https://files.pythonhosted.org/packages/2b/f9/f07a295cde762644aa4c4bb0f88921d2d141af45e735b965fb2e87858328/watchfiles-1.1.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5f3bde70f157f84ece3765b42b4a52c6ac1a50334903c6eaf765362f6ccca88a", size = 391783, upload-time = "2025-10-14T15:05:03.052Z" }, + { url = "https://files.pythonhosted.org/packages/bc/11/fc2502457e0bea39a5c958d86d2cb69e407a4d00b85735ca724bfa6e0d1a/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14e0b1fe858430fc0251737ef3824c54027bedb8c37c38114488b8e131cf8219", size = 449279, upload-time = "2025-10-14T15:05:04.004Z" }, + { url = "https://files.pythonhosted.org/packages/e3/1f/d66bc15ea0b728df3ed96a539c777acfcad0eb78555ad9efcaa1274688f0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f27db948078f3823a6bb3b465180db8ebecf26dd5dae6f6180bd87383b6b4428", size = 459405, upload-time = "2025-10-14T15:05:04.942Z" }, + { url = "https://files.pythonhosted.org/packages/be/90/9f4a65c0aec3ccf032703e6db02d89a157462fbb2cf20dd415128251cac0/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:059098c3a429f62fc98e8ec62b982230ef2c8df68c79e826e37b895bc359a9c0", size = 488976, upload-time = "2025-10-14T15:05:05.905Z" }, + { url = "https://files.pythonhosted.org/packages/37/57/ee347af605d867f712be7029bb94c8c071732a4b44792e3176fa3c612d39/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bfb5862016acc9b869bb57284e6cb35fdf8e22fe59f7548858e2f971d045f150", size = 595506, upload-time = "2025-10-14T15:05:06.906Z" }, + { url = "https://files.pythonhosted.org/packages/a8/78/cc5ab0b86c122047f75e8fc471c67a04dee395daf847d3e59381996c8707/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:319b27255aacd9923b8a276bb14d21a5f7ff82564c744235fc5eae58d95422ae", size = 474936, upload-time = "2025-10-14T15:05:07.906Z" }, + { url = "https://files.pythonhosted.org/packages/62/da/def65b170a3815af7bd40a3e7010bf6ab53089ef1b75d05dd5385b87cf08/watchfiles-1.1.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c755367e51db90e75b19454b680903631d41f9e3607fbd941d296a020c2d752d", size = 456147, upload-time = "2025-10-14T15:05:09.138Z" }, + { url = "https://files.pythonhosted.org/packages/57/99/da6573ba71166e82d288d4df0839128004c67d2778d3b566c138695f5c0b/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:c22c776292a23bfc7237a98f791b9ad3144b02116ff10d820829ce62dff46d0b", size = 630007, upload-time = "2025-10-14T15:05:10.117Z" }, + { url = "https://files.pythonhosted.org/packages/a8/51/7439c4dd39511368849eb1e53279cd3454b4a4dbace80bab88feeb83c6b5/watchfiles-1.1.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:3a476189be23c3686bc2f4321dd501cb329c0a0469e77b7b534ee10129ae6374", size = 622280, upload-time = "2025-10-14T15:05:11.146Z" }, + { url = "https://files.pythonhosted.org/packages/95/9c/8ed97d4bba5db6fdcdb2b298d3898f2dd5c20f6b73aee04eabe56c59677e/watchfiles-1.1.1-cp313-cp313-win32.whl", hash = "sha256:bf0a91bfb5574a2f7fc223cf95eeea79abfefa404bf1ea5e339c0c1560ae99a0", size = 272056, upload-time = "2025-10-14T15:05:12.156Z" }, + { url = "https://files.pythonhosted.org/packages/1f/f3/c14e28429f744a260d8ceae18bf58c1d5fa56b50d006a7a9f80e1882cb0d/watchfiles-1.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:52e06553899e11e8074503c8e716d574adeeb7e68913115c4b3653c53f9bae42", size = 288162, upload-time = "2025-10-14T15:05:13.208Z" }, + { url = "https://files.pythonhosted.org/packages/dc/61/fe0e56c40d5cd29523e398d31153218718c5786b5e636d9ae8ae79453d27/watchfiles-1.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:ac3cc5759570cd02662b15fbcd9d917f7ecd47efe0d6b40474eafd246f91ea18", size = 277909, upload-time = "2025-10-14T15:05:14.49Z" }, + { url = "https://files.pythonhosted.org/packages/79/42/e0a7d749626f1e28c7108a99fb9bf524b501bbbeb9b261ceecde644d5a07/watchfiles-1.1.1-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:563b116874a9a7ce6f96f87cd0b94f7faf92d08d0021e837796f0a14318ef8da", size = 403389, upload-time = "2025-10-14T15:05:15.777Z" }, + { url = "https://files.pythonhosted.org/packages/15/49/08732f90ce0fbbc13913f9f215c689cfc9ced345fb1bcd8829a50007cc8d/watchfiles-1.1.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3ad9fe1dae4ab4212d8c91e80b832425e24f421703b5a42ef2e4a1e215aff051", size = 389964, upload-time = "2025-10-14T15:05:16.85Z" }, + { url = "https://files.pythonhosted.org/packages/27/0d/7c315d4bd5f2538910491a0393c56bf70d333d51bc5b34bee8e68e8cea19/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce70f96a46b894b36eba678f153f052967a0d06d5b5a19b336ab0dbbd029f73e", size = 448114, upload-time = "2025-10-14T15:05:17.876Z" }, + { url = "https://files.pythonhosted.org/packages/c3/24/9e096de47a4d11bc4df41e9d1e61776393eac4cb6eb11b3e23315b78b2cc/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cb467c999c2eff23a6417e58d75e5828716f42ed8289fe6b77a7e5a91036ca70", size = 460264, upload-time = "2025-10-14T15:05:18.962Z" }, + { url = "https://files.pythonhosted.org/packages/cc/0f/e8dea6375f1d3ba5fcb0b3583e2b493e77379834c74fd5a22d66d85d6540/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:836398932192dae4146c8f6f737d74baeac8b70ce14831a239bdb1ca882fc261", size = 487877, upload-time = "2025-10-14T15:05:20.094Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5b/df24cfc6424a12deb41503b64d42fbea6b8cb357ec62ca84a5a3476f654a/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:743185e7372b7bc7c389e1badcc606931a827112fbbd37f14c537320fca08620", size = 595176, upload-time = "2025-10-14T15:05:21.134Z" }, + { url = "https://files.pythonhosted.org/packages/8f/b5/853b6757f7347de4e9b37e8cc3289283fb983cba1ab4d2d7144694871d9c/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:afaeff7696e0ad9f02cbb8f56365ff4686ab205fcf9c4c5b6fdfaaa16549dd04", size = 473577, upload-time = "2025-10-14T15:05:22.306Z" }, + { url = "https://files.pythonhosted.org/packages/e1/f7/0a4467be0a56e80447c8529c9fce5b38eab4f513cb3d9bf82e7392a5696b/watchfiles-1.1.1-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3f7eb7da0eb23aa2ba036d4f616d46906013a68caf61b7fdbe42fc8b25132e77", size = 455425, upload-time = "2025-10-14T15:05:23.348Z" }, + { url = "https://files.pythonhosted.org/packages/8e/e0/82583485ea00137ddf69bc84a2db88bd92ab4a6e3c405e5fb878ead8d0e7/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:831a62658609f0e5c64178211c942ace999517f5770fe9436be4c2faeba0c0ef", size = 628826, upload-time = "2025-10-14T15:05:24.398Z" }, + { url = "https://files.pythonhosted.org/packages/28/9a/a785356fccf9fae84c0cc90570f11702ae9571036fb25932f1242c82191c/watchfiles-1.1.1-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:f9a2ae5c91cecc9edd47e041a930490c31c3afb1f5e6d71de3dc671bfaca02bf", size = 622208, upload-time = "2025-10-14T15:05:25.45Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f4/0872229324ef69b2c3edec35e84bd57a1289e7d3fe74588048ed8947a323/watchfiles-1.1.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:d1715143123baeeaeadec0528bb7441103979a1d5f6fd0e1f915383fea7ea6d5", size = 404315, upload-time = "2025-10-14T15:05:26.501Z" }, + { url = "https://files.pythonhosted.org/packages/7b/22/16d5331eaed1cb107b873f6ae1b69e9ced582fcf0c59a50cd84f403b1c32/watchfiles-1.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:39574d6370c4579d7f5d0ad940ce5b20db0e4117444e39b6d8f99db5676c52fd", size = 390869, upload-time = "2025-10-14T15:05:27.649Z" }, + { url = "https://files.pythonhosted.org/packages/b2/7e/5643bfff5acb6539b18483128fdc0ef2cccc94a5b8fbda130c823e8ed636/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7365b92c2e69ee952902e8f70f3ba6360d0d596d9299d55d7d386df84b6941fb", size = 449919, upload-time = "2025-10-14T15:05:28.701Z" }, + { url = "https://files.pythonhosted.org/packages/51/2e/c410993ba5025a9f9357c376f48976ef0e1b1aefb73b97a5ae01a5972755/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bfff9740c69c0e4ed32416f013f3c45e2ae42ccedd1167ef2d805c000b6c71a5", size = 460845, upload-time = "2025-10-14T15:05:30.064Z" }, + { url = "https://files.pythonhosted.org/packages/8e/a4/2df3b404469122e8680f0fcd06079317e48db58a2da2950fb45020947734/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b27cf2eb1dda37b2089e3907d8ea92922b673c0c427886d4edc6b94d8dfe5db3", size = 489027, upload-time = "2025-10-14T15:05:31.064Z" }, + { url = "https://files.pythonhosted.org/packages/ea/84/4587ba5b1f267167ee715b7f66e6382cca6938e0a4b870adad93e44747e6/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:526e86aced14a65a5b0ec50827c745597c782ff46b571dbfe46192ab9e0b3c33", size = 595615, upload-time = "2025-10-14T15:05:32.074Z" }, + { url = "https://files.pythonhosted.org/packages/6a/0f/c6988c91d06e93cd0bb3d4a808bcf32375ca1904609835c3031799e3ecae/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:04e78dd0b6352db95507fd8cb46f39d185cf8c74e4cf1e4fbad1d3df96faf510", size = 474836, upload-time = "2025-10-14T15:05:33.209Z" }, + { url = "https://files.pythonhosted.org/packages/b4/36/ded8aebea91919485b7bbabbd14f5f359326cb5ec218cd67074d1e426d74/watchfiles-1.1.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5c85794a4cfa094714fb9c08d4a218375b2b95b8ed1666e8677c349906246c05", size = 455099, upload-time = "2025-10-14T15:05:34.189Z" }, + { url = "https://files.pythonhosted.org/packages/98/e0/8c9bdba88af756a2fce230dd365fab2baf927ba42cd47521ee7498fd5211/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:74d5012b7630714b66be7b7b7a78855ef7ad58e8650c73afc4c076a1f480a8d6", size = 630626, upload-time = "2025-10-14T15:05:35.216Z" }, + { url = "https://files.pythonhosted.org/packages/2a/84/a95db05354bf2d19e438520d92a8ca475e578c647f78f53197f5a2f17aaf/watchfiles-1.1.1-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:8fbe85cb3201c7d380d3d0b90e63d520f15d6afe217165d7f98c9c649654db81", size = 622519, upload-time = "2025-10-14T15:05:36.259Z" }, + { url = "https://files.pythonhosted.org/packages/1d/ce/d8acdc8de545de995c339be67711e474c77d643555a9bb74a9334252bd55/watchfiles-1.1.1-cp314-cp314-win32.whl", hash = "sha256:3fa0b59c92278b5a7800d3ee7733da9d096d4aabcfabb9a928918bd276ef9b9b", size = 272078, upload-time = "2025-10-14T15:05:37.63Z" }, + { url = "https://files.pythonhosted.org/packages/c4/c9/a74487f72d0451524be827e8edec251da0cc1fcf111646a511ae752e1a3d/watchfiles-1.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:c2047d0b6cea13b3316bdbafbfa0c4228ae593d995030fda39089d36e64fc03a", size = 287664, upload-time = "2025-10-14T15:05:38.95Z" }, + { url = "https://files.pythonhosted.org/packages/df/b8/8ac000702cdd496cdce998c6f4ee0ca1f15977bba51bdf07d872ebdfc34c/watchfiles-1.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:842178b126593addc05acf6fce960d28bc5fae7afbaa2c6c1b3a7b9460e5be02", size = 277154, upload-time = "2025-10-14T15:05:39.954Z" }, + { url = "https://files.pythonhosted.org/packages/47/a8/e3af2184707c29f0f14b1963c0aace6529f9d1b8582d5b99f31bbf42f59e/watchfiles-1.1.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:88863fbbc1a7312972f1c511f202eb30866370ebb8493aef2812b9ff28156a21", size = 403820, upload-time = "2025-10-14T15:05:40.932Z" }, + { url = "https://files.pythonhosted.org/packages/c0/ec/e47e307c2f4bd75f9f9e8afbe3876679b18e1bcec449beca132a1c5ffb2d/watchfiles-1.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:55c7475190662e202c08c6c0f4d9e345a29367438cf8e8037f3155e10a88d5a5", size = 390510, upload-time = "2025-10-14T15:05:41.945Z" }, + { url = "https://files.pythonhosted.org/packages/d5/a0/ad235642118090f66e7b2f18fd5c42082418404a79205cdfca50b6309c13/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3f53fa183d53a1d7a8852277c92b967ae99c2d4dcee2bfacff8868e6e30b15f7", size = 448408, upload-time = "2025-10-14T15:05:43.385Z" }, + { url = "https://files.pythonhosted.org/packages/df/85/97fa10fd5ff3332ae17e7e40e20784e419e28521549780869f1413742e9d/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6aae418a8b323732fa89721d86f39ec8f092fc2af67f4217a2b07fd3e93c6101", size = 458968, upload-time = "2025-10-14T15:05:44.404Z" }, + { url = "https://files.pythonhosted.org/packages/47/c2/9059c2e8966ea5ce678166617a7f75ecba6164375f3b288e50a40dc6d489/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:f096076119da54a6080e8920cbdaac3dbee667eb91dcc5e5b78840b87415bd44", size = 488096, upload-time = "2025-10-14T15:05:45.398Z" }, + { url = "https://files.pythonhosted.org/packages/94/44/d90a9ec8ac309bc26db808a13e7bfc0e4e78b6fc051078a554e132e80160/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:00485f441d183717038ed2e887a7c868154f216877653121068107b227a2f64c", size = 596040, upload-time = "2025-10-14T15:05:46.502Z" }, + { url = "https://files.pythonhosted.org/packages/95/68/4e3479b20ca305cfc561db3ed207a8a1c745ee32bf24f2026a129d0ddb6e/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a55f3e9e493158d7bfdb60a1165035f1cf7d320914e7b7ea83fe22c6023b58fc", size = 473847, upload-time = "2025-10-14T15:05:47.484Z" }, + { url = "https://files.pythonhosted.org/packages/4f/55/2af26693fd15165c4ff7857e38330e1b61ab8c37d15dc79118cdba115b7a/watchfiles-1.1.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c91ed27800188c2ae96d16e3149f199d62f86c7af5f5f4d2c61a3ed8cd3666c", size = 455072, upload-time = "2025-10-14T15:05:48.928Z" }, + { url = "https://files.pythonhosted.org/packages/66/1d/d0d200b10c9311ec25d2273f8aad8c3ef7cc7ea11808022501811208a750/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:311ff15a0bae3714ffb603e6ba6dbfba4065ab60865d15a6ec544133bdb21099", size = 629104, upload-time = "2025-10-14T15:05:49.908Z" }, + { url = "https://files.pythonhosted.org/packages/e3/bd/fa9bb053192491b3867ba07d2343d9f2252e00811567d30ae8d0f78136fe/watchfiles-1.1.1-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:a916a2932da8f8ab582f242c065f5c81bed3462849ca79ee357dd9551b0e9b01", size = 622112, upload-time = "2025-10-14T15:05:50.941Z" }, + { url = "https://files.pythonhosted.org/packages/ba/4c/a888c91e2e326872fa4705095d64acd8aa2fb9c1f7b9bd0588f33850516c/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:17ef139237dfced9da49fb7f2232c86ca9421f666d78c264c7ffca6601d154c3", size = 409611, upload-time = "2025-10-14T15:06:05.809Z" }, + { url = "https://files.pythonhosted.org/packages/1e/c7/5420d1943c8e3ce1a21c0a9330bcf7edafb6aa65d26b21dbb3267c9e8112/watchfiles-1.1.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:672b8adf25b1a0d35c96b5888b7b18699d27d4194bac8beeae75be4b7a3fc9b2", size = 396889, upload-time = "2025-10-14T15:06:07.035Z" }, + { url = "https://files.pythonhosted.org/packages/0c/e5/0072cef3804ce8d3aaddbfe7788aadff6b3d3f98a286fdbee9fd74ca59a7/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a13aea58bc2b90173bc69f2a90de8e282648939a00a602e1dc4ee23e26b66d", size = 451616, upload-time = "2025-10-14T15:06:08.072Z" }, + { url = "https://files.pythonhosted.org/packages/83/4e/b87b71cbdfad81ad7e83358b3e447fedd281b880a03d64a760fe0a11fc2e/watchfiles-1.1.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0b495de0bb386df6a12b18335a0285dda90260f51bdb505503c02bcd1ce27a8b", size = 458413, upload-time = "2025-10-14T15:06:09.209Z" }, + { url = "https://files.pythonhosted.org/packages/d3/8e/e500f8b0b77be4ff753ac94dc06b33d8f0d839377fee1b78e8c8d8f031bf/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:db476ab59b6765134de1d4fe96a1a9c96ddf091683599be0f26147ea1b2e4b88", size = 408250, upload-time = "2025-10-14T15:06:10.264Z" }, + { url = "https://files.pythonhosted.org/packages/bd/95/615e72cd27b85b61eec764a5ca51bd94d40b5adea5ff47567d9ebc4d275a/watchfiles-1.1.1-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:89eef07eee5e9d1fda06e38822ad167a044153457e6fd997f8a858ab7564a336", size = 396117, upload-time = "2025-10-14T15:06:11.28Z" }, + { url = "https://files.pythonhosted.org/packages/c9/81/e7fe958ce8a7fb5c73cc9fb07f5aeaf755e6aa72498c57d760af760c91f8/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ce19e06cbda693e9e7686358af9cd6f5d61312ab8b00488bc36f5aabbaf77e24", size = 450493, upload-time = "2025-10-14T15:06:12.321Z" }, + { url = "https://files.pythonhosted.org/packages/6e/d4/ed38dd3b1767193de971e694aa544356e63353c33a85d948166b5ff58b9e/watchfiles-1.1.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3e6f39af2eab0118338902798b5aa6664f46ff66bc0280de76fca67a7f262a49", size = 457546, upload-time = "2025-10-14T15:06:13.372Z" }, +] + [[package]] name = "websockets" version = "15.0.1" diff --git a/clio-kit-mcp-servers/slurm/.claude-plugin/plugin.json b/clio-kit-mcp-servers/slurm/.claude-plugin/plugin.json new file mode 100644 index 00000000..b053d29e --- /dev/null +++ b/clio-kit-mcp-servers/slurm/.claude-plugin/plugin.json @@ -0,0 +1,5 @@ +{ + "name": "clio-slurm", + "description": "MCP server for Slurm workload management and HPC job scheduling", + "version": "1.0.0" +} diff --git a/clio-kit-mcp-servers/slurm/.mcp.json b/clio-kit-mcp-servers/slurm/.mcp.json new file mode 100644 index 00000000..2b18c22e --- /dev/null +++ b/clio-kit-mcp-servers/slurm/.mcp.json @@ -0,0 +1,9 @@ +{ + "clio-slurm": { + "command": "uvx", + "args": [ + "clio-kit", + "slurm" + ] + } +} diff --git a/clio-kit-mcp-servers/slurm/README.md b/clio-kit-mcp-servers/slurm/README.md index 914e55f8..f94fed18 100644 --- a/clio-kit-mcp-servers/slurm/README.md +++ b/clio-kit-mcp-servers/slurm/README.md @@ -131,121 +131,126 @@ uv --directory=$env:CLONE_DIR\clio-kit\clio-kit-mcp-servers\slurm run slurm-mcp ## Capabilities ### `submit_slurm_job` -**Description**: Submit a job script to Slurm scheduler with advanced resource specification and intelligent optimization. - -**Parameters**: -- `script_path` (str): Parameter for script_path -- `cores` (int, optional): Parameter for cores (default: 1) -- `memory` (str, optional): Parameter for memory (default: 1GB) -- `time_limit` (str, optional): Parameter for time_limit (default: 01:00:00) -- `job_name` (Any, optional): Parameter for job_name -- `partition` (Any, optional): Parameter for partition - -**Returns**: Dictionary containing comprehensive job submission results with scheduling insights +**Description**: Submit a job script to the Slurm scheduler with resource requirements. +**Tags**: jobs, submission ### `check_job_status` -**Description**: Check comprehensive status of a Slurm job with advanced monitoring and intelligent analysis. - -**Parameters**: -- `job_id` (str): Parameter for job_id - -**Returns**: Dictionary containing comprehensive job status with performance insights and optimization recommendations +**Description**: Check the status of a Slurm job by its ID. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring ### `cancel_slurm_job` -**Description**: Cancel a Slurm job. - -**Parameters**: -- `job_id` (str): Parameter for job_id - -**Returns**: Dictionary with cancellation results +**Description**: Cancel a running or pending Slurm job. +**Hints**: destructive, idempotent +**Tags**: jobs, management ### `list_slurm_jobs` -**Description**: List Slurm jobs with optional filtering. - -**Parameters**: -- `user` (Any, optional): Parameter for user -- `state` (Any, optional): Parameter for state - -**Returns**: Dictionary with list of jobs +**Description**: List Slurm jobs with optional filtering by user and state. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring ### `get_slurm_info` -**Description**: Get information about the Slurm cluster. - -**Returns**: Dictionary with cluster information +**Description**: Get Slurm cluster configuration, partitions, and resource availability. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring ### `get_job_details` -**Description**: Get detailed information about a Slurm job. - -**Parameters**: -- `job_id` (str): Parameter for job_id - -**Returns**: Dictionary with detailed job information +**Description**: Get detailed information about a specific Slurm job. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring ### `get_job_output` -**Description**: Get job output content. +**Description**: Retrieve stdout or stderr output from a Slurm job. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring -**Parameters**: -- `job_id` (str): Parameter for job_id -- `output_type` (str, optional): Parameter for output_type (default: stdout) +### `get_queue_info` +**Description**: Get Slurm queue status and partition information. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring -**Returns**: Dictionary with job output content +### `submit_array_job` +**Description**: Submit a Slurm array job for parallel task execution. +**Tags**: jobs, submission -### `get_queue_info` -**Description**: Get job queue information. +### `get_node_info` +**Description**: Get information about Slurm cluster nodes and their resources. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring -**Parameters**: -- `partition` (Any, optional): Parameter for partition +### `allocate_slurm_nodes` +**Description**: Allocate Slurm nodes for an interactive session using salloc. +**Tags**: jobs, submission -**Returns**: Dictionary with queue information +### `deallocate_slurm_nodes` +**Description**: Release a Slurm node allocation by canceling it. +**Hints**: destructive, idempotent +**Tags**: jobs, management -### `submit_array_job` -**Description**: Submit an array job to Slurm scheduler. +### `get_allocation_status` +**Description**: Check the status of a Slurm node allocation. +**Hints**: read-only, idempotent +**Tags**: jobs, monitoring -**Parameters**: -- `script_path` (str): Parameter for script_path -- `array_range` (str): Parameter for array_range -- `cores` (int, optional): Parameter for cores (default: 1) -- `memory` (str, optional): Parameter for memory (default: 1GB) -- `time_limit` (str, optional): Parameter for time_limit (default: 01:00:00) -- `job_name` (Any, optional): Parameter for job_name -- `partition` (Any, optional): Parameter for partition +### Resources -**Returns**: Dictionary with array job submission results +- `slurm://cluster-info` - Basic Slurm cluster configuration. -### `get_node_info` -**Description**: Get cluster node information. +### Prompts -**Returns**: Dictionary with node information +- **submit_job_workflow**: Guided workflow for submitting and monitoring a Slurm job. +## Claude Code -### `allocate_slurm_nodes` -**Description**: Allocate Slurm nodes using salloc command. +```bash +claude mcp add clio-slurm -- uvx clio-kit slurm +``` -**Parameters**: -- `nodes` (int, optional): Parameter for nodes (default: 1) -- `cores` (int, optional): Parameter for cores (default: 1) -- `memory` (Any, optional): Parameter for memory -- `time_limit` (str, optional): Parameter for time_limit (default: 01:00:00) -- `partition` (Any, optional): Parameter for partition -- `job_name` (Any, optional): Parameter for job_name -- `immediate` (bool, optional): Parameter for immediate (default: False) +Or install via the CLIO Kit plugin marketplace: -**Returns**: Dictionary with allocation information +``` +/plugin marketplace add iowarp/clio-kit +/plugin install clio-slurm@iowarp-clio-kit +``` +## Claude Desktop -### `deallocate_slurm_nodes` -**Description**: Deallocate Slurm nodes by canceling the allocation. +Add to your Claude Desktop config (`claude_desktop_config.json`): -**Parameters**: -- `allocation_id` (str): Parameter for allocation_id +```json +{ + "mcpServers": { + "clio-slurm": { + "command": "uvx", + "args": [ + "clio-kit", + "slurm" + ] + } + } +} +``` +## Gemini CLI -**Returns**: Dictionary with deallocation status +Add to `~/.gemini/settings.json`: -### `get_allocation_status` -**Description**: Get status of a node allocation. +```json +{ + "mcpServers": { + "clio-slurm": { + "command": "uvx", + "args": [ + "clio-kit", + "slurm" + ] + } + } +} +``` -**Parameters**: -- `allocation_id` (str): Parameter for allocation_id +Or install the CLIO Kit extension: -**Returns**: Dictionary with allocation status information +```bash +gemini extensions install https://github.com/iowarp/clio-kit +``` ## Examples ### 1. Job Submission and Monitoring diff --git a/clio-kit-mcp-servers/slurm/pyproject.toml b/clio-kit-mcp-servers/slurm/pyproject.toml index 7040c2af..803af593 100644 --- a/clio-kit-mcp-servers/slurm/pyproject.toml +++ b/clio-kit-mcp-servers/slurm/pyproject.toml @@ -12,7 +12,7 @@ authors = [ keywords = ["MCP", "Slurm", "HPC", "job-management", "cluster-monitoring", "workload-management", "scientific-computing", "high-performance-computing"] dependencies = [ - "fastmcp>=2.13.0", + "fastmcp>=3.0.0rc2", "psutil>=7.0.0", "python-dotenv>=1.0.0", ] @@ -33,8 +33,16 @@ dev = [ ] [project.scripts] -slurm-mcp = "server:main" +slurm-mcp = "slurm_mcp.server:main" [build-system] -requires = ["setuptools>=64.0", "wheel"] -build-backend = "setuptools.build_meta" +requires = ["hatchling"] +build-backend = "hatchling.build" + +[tool.hatch.build.targets.wheel] +packages = ["src/slurm_mcp"] + +[tool.pytest.ini_options] +pythonpath = ["src"] +testpaths = ["tests"] +asyncio_mode = "auto" diff --git a/clio-kit-mcp-servers/slurm/pytest.ini b/clio-kit-mcp-servers/slurm/pytest.ini index 80653251..60c85e70 100644 --- a/clio-kit-mcp-servers/slurm/pytest.ini +++ b/clio-kit-mcp-servers/slurm/pytest.ini @@ -2,4 +2,5 @@ markers = slow: marks tests as slow (deselect with '-m "not slow"') testpaths = tests -addopts = --tb=short \ No newline at end of file +addopts = --tb=short +asyncio_mode = auto \ No newline at end of file diff --git a/clio-kit-mcp-servers/slurm/server.json b/clio-kit-mcp-servers/slurm/server.json new file mode 100644 index 00000000..6630d517 --- /dev/null +++ b/clio-kit-mcp-servers/slurm/server.json @@ -0,0 +1,87 @@ +{ + "name": "io.github.iowarp/slurm-mcp", + "description": "MCP server for Slurm workload management and HPC job scheduling", + "version": "1.0.0", + "repository": "https://github.com/iowarp/clio-kit", + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": [ + "clio-kit", + "slurm" + ] + }, + "tools": [ + { + "name": "submit_slurm_job", + "description": "Submit a job script to the Slurm scheduler with resource requirements." + }, + { + "name": "check_job_status", + "description": "Check the status of a Slurm job by its ID." + }, + { + "name": "cancel_slurm_job", + "description": "Cancel a running or pending Slurm job." + }, + { + "name": "list_slurm_jobs", + "description": "List Slurm jobs with optional filtering by user and state." + }, + { + "name": "get_slurm_info", + "description": "Get Slurm cluster configuration, partitions, and resource availability." + }, + { + "name": "get_job_details", + "description": "Get detailed information about a specific Slurm job." + }, + { + "name": "get_job_output", + "description": "Retrieve stdout or stderr output from a Slurm job." + }, + { + "name": "get_queue_info", + "description": "Get Slurm queue status and partition information." + }, + { + "name": "submit_array_job", + "description": "Submit a Slurm array job for parallel task execution." + }, + { + "name": "get_node_info", + "description": "Get information about Slurm cluster nodes and their resources." + }, + { + "name": "allocate_slurm_nodes", + "description": "Allocate Slurm nodes for an interactive session using salloc." + }, + { + "name": "deallocate_slurm_nodes", + "description": "Release a Slurm node allocation by canceling it." + }, + { + "name": "get_allocation_status", + "description": "Check the status of a Slurm node allocation." + } + ], + "resources": [ + { + "uri": "slurm://cluster-info", + "name": "cluster_info", + "description": "Basic Slurm cluster configuration." + } + ], + "prompts": [ + { + "name": "submit_job_workflow", + "description": "Guided workflow for submitting and monitoring a Slurm job." + } + ], + "tags": [ + "hpc", + "slurm", + "job-scheduling", + "cluster-management" + ] +} diff --git a/clio-kit-mcp-servers/slurm/src/__init__.py b/clio-kit-mcp-servers/slurm/src/__init__.py deleted file mode 100644 index ee96cfce..00000000 --- a/clio-kit-mcp-servers/slurm/src/__init__.py +++ /dev/null @@ -1,10 +0,0 @@ -""" -Slurm MCP Server - A comprehensive Model Context Protocol server for Slurm job management. - -This package provides a FastMCP-based server that enables interaction with Slurm -workload manager through the Model Context Protocol, offering job submission, -monitoring, and cluster management capabilities. -""" - -__version__ = "1.0.0" -__author__ = "IoWarp Scientific MCPs" diff --git a/clio-kit-mcp-servers/slurm/src/server.py b/clio-kit-mcp-servers/slurm/src/server.py deleted file mode 100644 index c6928495..00000000 --- a/clio-kit-mcp-servers/slurm/src/server.py +++ /dev/null @@ -1,937 +0,0 @@ -""" -Slurm MCP Server - Comprehensive HPC Job Management and Cluster Monitoring - -This server provides comprehensive HPC job management and cluster monitoring capabilities through -the Model Context Protocol, enabling users to submit jobs, monitor cluster resources, and manage -workloads across Slurm-managed HPC systems with intelligent job scheduling and resource optimization. - -Following MCP best practices, this server is designed with a workflow-first approach -providing intelligent, contextual assistance for HPC job management, cluster monitoring, -and resource optimization workflows. -""" - -import os -import sys -import logging -from typing import Optional - -# Try to import required dependencies with fallbacks -try: - from fastmcp import FastMCP -except ImportError: - print("FastMCP not available. Please install with: uv add fastmcp", file=sys.stderr) - sys.exit(1) - -try: - from dotenv import load_dotenv - - load_dotenv() -except ImportError: - print( - "Warning: python-dotenv not available. Environment variables may not be loaded.", - file=sys.stderr, - ) - -# Add current directory to path for relative imports -sys.path.insert(0, os.path.dirname(__file__)) - -# Import implementation modules directly -from implementation.job_submission import submit_slurm_job -from implementation.job_status import get_job_status -from implementation.job_cancellation import cancel_slurm_job -from implementation.job_listing import list_slurm_jobs -from implementation.cluster_info import get_slurm_info -from implementation.job_details import get_job_details -from implementation.job_output import get_job_output -from implementation.queue_info import get_queue_info -from implementation.array_jobs import submit_array_job -from implementation.node_info import get_node_info -from implementation.node_allocation import ( - allocate_nodes, - deallocate_nodes, - get_allocation_status, -) - -# Set up logging -logging.basicConfig(level=logging.INFO) -logger = logging.getLogger(__name__) - -# Initialize FastMCP server instance -mcp: FastMCP = FastMCP("Slurm-MCP-JobManagement") - - -# Custom exception for Slurm MCP errors -class SlurmMCPError(Exception): - """Custom exception for Slurm MCP-related errors""" - - pass - - -# ═══════════════════════════════════════════════════════════════════════════════ -# SLURM JOB MANAGEMENT TOOLS -# ═══════════════════════════════════════════════════════════════════════════════ - - -@mcp.tool( - name="submit_slurm_job", - description="""Submit Slurm jobs with comprehensive resource specification and intelligent job optimization. - -This powerful tool provides complete job submission capabilities by accepting script files and resource requirements, -then submitting them to the Slurm scheduler with advanced parameter validation, intelligent optimization, and -comprehensive job lifecycle management. - -**Intelligent Job Submission Strategy**: -1. **Resource Validation**: Comprehensive validation of CPU, memory, and time requirements with intelligent defaults and optimization -2. **Script Analysis**: Automatic analysis of script requirements and compatibility with cluster capabilities -3. **Queue Selection**: Smart partition and queue selection based on resource requirements, availability, and historical performance -4. **Intelligent Scheduling**: AI-powered scheduling recommendations based on cluster state, job characteristics, and performance patterns -5. **Performance Optimization**: Resource allocation optimization with efficiency analysis and cost-effectiveness recommendations - -**Advanced Job Submission Features**: -- **Resource Requirements**: CPU cores, memory allocation, time limits with intelligent scaling and optimization -- **Queue Management**: Automatic partition selection with load balancing and performance optimization -- **Job Naming**: Intelligent job naming with metadata tracking and organization -- **Script Validation**: Comprehensive script analysis with compatibility checking and optimization suggestions -- **Resource Efficiency**: Automatic resource optimization with usage prediction and cost analysis -- **Job Prioritization**: Smart priority assignment based on resource requirements and cluster policies - -**Optimization Intelligence**: -- **Resource Sizing**: Intelligent resource recommendation based on script analysis and historical data -- **Queue Selection**: Optimal partition selection based on resource availability and job characteristics -- **Time Estimation**: Intelligent time limit suggestions based on workload analysis and cluster performance -- **Cost Optimization**: Resource allocation optimization for cost-effectiveness and efficiency -- **Performance Prediction**: Job performance estimation with bottleneck identification and optimization - -**Prerequisites**: Valid Slurm cluster access with job submission capabilities and script file availability -**Tools to use before this**: get_slurm_info() to verify cluster capabilities, get_queue_info() for availability analysis -**Tools to use after this**: check_job_status() for monitoring, get_job_details() for analysis, get_job_output() for results - -Use this tool when: -- Submitting computational jobs to HPC clusters with optimized resource allocation ("Submit my parallel simulation with intelligent resource optimization") -- Deploying batch workloads with specific resource requirements and intelligent scheduling optimization -- Running scientific applications with AI-powered resource allocation and performance monitoring -- Executing high-throughput computing workflows with intelligent job scheduling and queue management -- Optimizing job submission for cost-effectiveness and performance efficiency with predictive analysis""", -) -async def submit_slurm_job_tool( - script_path: str, - cores: int = 1, - memory: str = "1GB", - time_limit: str = "01:00:00", - job_name: Optional[str] = None, - partition: Optional[str] = None, -) -> dict: - """ - Submit a job script to Slurm scheduler with advanced resource specification and intelligent optimization. - - Args: - script_path: Path to the job script file (required) - cores: Number of CPU cores to request with intelligent resource allocation (default: 1, must be > 0) - memory: Memory requirement with automatic unit conversion (e.g., "4G", "2048M", default: "1GB") - time_limit: Time limit in HH:MM:SS format with intelligent duration estimation (default: "01:00:00") - job_name: Custom job name for easy identification (default: derived from script filename) - partition: Slurm partition selection with automatic queue optimization (default: system default) - - Returns: - Dictionary containing comprehensive job submission results with scheduling insights - """ - try: - logger.info( - f"Submitting comprehensive Slurm job: {script_path} with {cores} cores and advanced resource optimization" - ) - - return submit_slurm_job( - script_path, cores, memory, time_limit, job_name, partition - ) - except Exception as e: - logger.error(f"Job submission error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "JobSubmissionError", "troubleshooting": "Check script path, resource requirements, and cluster connectivity"}}' - } - ], - "_meta": {"tool": "submit_slurm_job", "error": "JobSubmissionError"}, - "isError": True, - } - - -@mcp.tool( - name="check_job_status", - description="""Check comprehensive Slurm job status with advanced monitoring, performance insights, and intelligent analysis. - -This powerful tool provides complete job status analysis by querying the Slurm scheduler and delivering detailed -status information with intelligent analysis, performance metrics, optimization recommendations, and predictive insights -for comprehensive job lifecycle management. - -**Intelligent Job Status Analysis**: -1. **Real-Time Monitoring**: Comprehensive job state tracking with performance analysis and trend monitoring -2. **Performance Analytics**: Resource utilization analysis with efficiency metrics and optimization insights -3. **Predictive Analysis**: Job completion estimation with performance trend analysis and bottleneck identification -4. **Health Assessment**: Job health monitoring with issue detection and optimization recommendations -5. **Resource Optimization**: Usage pattern analysis with efficiency recommendations and cost optimization - -**Advanced Status Information**: -- **Job State Tracking**: Current status, queue position, execution progress with intelligent state analysis -- **Resource Utilization**: CPU, memory, I/O usage with efficiency analysis and optimization recommendations -- **Performance Metrics**: Runtime analysis, throughput measurement, and performance trend identification -- **Queue Analytics**: Position analysis, estimated wait time, and scheduling optimization insights -- **Error Detection**: Intelligent error identification with diagnostic analysis and resolution recommendations - -**Monitoring Intelligence**: -- **Progress Prediction**: Intelligent job completion time estimation based on current performance and historical data -- **Performance Analysis**: Real-time performance monitoring with bottleneck identification and optimization suggestions -- **Resource Efficiency**: Usage pattern analysis with efficiency scoring and cost-effectiveness recommendations -- **Issue Detection**: Automated problem identification with diagnostic insights and resolution strategies -- **Trend Analysis**: Performance trend monitoring with predictive maintenance and optimization guidance - -**Optimization Insights**: -- **Resource Usage**: Comprehensive analysis of CPU, memory, and I/O utilization with optimization recommendations -- **Performance Optimization**: Bottleneck identification with performance improvement strategies and best practices -- **Cost Analysis**: Resource cost analysis with optimization suggestions for future job submissions -- **Efficiency Scoring**: Job efficiency evaluation with improvement recommendations and best practice guidance - -**Prerequisites**: Valid Slurm job ID from previous job submission with cluster access for monitoring -**Tools to use before this**: submit_slurm_job() to get job ID, list_slurm_jobs() for job discovery -**Tools to use after this**: get_job_details() for comprehensive analysis, get_job_output() for results, or cancel_slurm_job() if needed - -Use this tool when: -- Monitoring job progress and execution status with intelligent performance analysis ("Check my simulation job performance and optimization opportunities") -- Tracking resource utilization and performance metrics with predictive insights and efficiency recommendations -- Identifying job issues and optimization opportunities with AI-powered diagnostic analysis and resolution strategies -- Analyzing job performance for optimization and efficiency improvement with comprehensive metrics and recommendations -- Monitoring job health and predicting completion times with intelligent analysis and trend monitoring""", -) -async def check_job_status_tool(job_id: str) -> dict: - """ - Check comprehensive status of a Slurm job with advanced monitoring and intelligent analysis. - - Args: - job_id: The Slurm job ID to check (required) - - Returns: - Dictionary containing comprehensive job status with performance insights and optimization recommendations - """ - try: - logger.info( - f"Checking comprehensive status for job: {job_id} with advanced monitoring and intelligent analysis" - ) - - return get_job_status(job_id) - except Exception as e: - logger.error(f"Job status check error: {e}") - return { - "content": [ - { - "text": f'{{"success": false, "error": "{str(e)}", "error_type": "JobStatusError", "troubleshooting": "Verify job ID exists and cluster connectivity"}}' - } - ], - "_meta": {"tool": "check_job_status", "error": "JobStatusError"}, - "isError": True, - } - - -@mcp.tool( - name="cancel_slurm_job", - description="""Cancel Slurm jobs with intelligent resource cleanup and comprehensive lifecycle management. - -This powerful tool provides complete job cancellation capabilities with intelligent resource cleanup, -impact analysis, and optimization recommendations for efficient cluster resource management and -workflow optimization. - -**Intelligent Job Cancellation Strategy**: -1. **Safe Cancellation**: Comprehensive job termination with graceful shutdown and resource cleanup -2. **Impact Analysis**: Assessment of cancellation impact on dependent jobs and cluster resources -3. **Resource Recovery**: Intelligent resource cleanup with optimization for cluster efficiency -4. **Data Preservation**: Analysis of output preservation and recovery recommendations -5. **Cost Analysis**: Resource usage analysis with cost impact assessment and optimization insights - -**Advanced Cancellation Features**: -- **Graceful Termination**: Safe job termination with checkpoint preservation and data integrity -- **Resource Cleanup**: Automatic resource deallocation with cluster optimization and efficiency analysis -- **Impact Assessment**: Analysis of cancellation effects on job dependencies and cluster performance -- **Data Recovery**: Intelligent analysis of recoverable outputs and checkpoint preservation strategies -- **Queue Optimization**: Post-cancellation queue optimization with resource reallocation recommendations - -**Optimization Intelligence**: -- **Resource Efficiency**: Analysis of resource recovery and cluster optimization opportunities -- **Cost Impact**: Assessment of cancellation costs and optimization recommendations for future submissions -- **Workflow Analysis**: Impact assessment on dependent jobs with optimization strategies -- **Performance Insights**: Analysis of cancellation reasons with prevention recommendations and best practices - -**Prerequisites**: Valid Slurm job ID and appropriate permissions for job cancellation -**Tools to use before this**: check_job_status() to verify job state, get_job_details() for impact analysis -**Tools to use after this**: list_slurm_jobs() to verify cancellation, get_queue_info() for resource reallocation analysis - -Use this tool when: -- Canceling problematic jobs with intelligent resource recovery ("Cancel job with resource optimization analysis") -- Terminating jobs that are no longer needed with efficient resource cleanup and cost analysis -- Managing job priorities with intelligent cancellation and resource reallocation strategies -- Optimizing cluster resources through strategic job cancellation and queue management""", -) -async def cancel_slurm_job_tool(job_id: str) -> dict: - """ - Cancel a Slurm job. - - Args: - job_id: The Slurm job ID to cancel - - Returns: - Dictionary with cancellation results - """ - logger.info(f"Cancelling job: {job_id}") - return cancel_slurm_job(job_id) - - -@mcp.tool( - name="list_slurm_jobs", - description="""List and analyze Slurm jobs with comprehensive filtering, intelligent analysis, and optimization insights. - -This powerful tool provides complete job listing capabilities with sophisticated filtering, intelligent job analysis, -performance metrics, and optimization recommendations for comprehensive cluster workload management and -workflow optimization. - -**Intelligent Job Listing Strategy**: -1. **Comprehensive Discovery**: Advanced job discovery with intelligent filtering and categorization -2. **Performance Analysis**: Job performance evaluation with efficiency metrics and optimization insights -3. **Resource Utilization**: Cluster resource analysis with usage patterns and optimization recommendations -4. **Queue Intelligence**: Queue analysis with scheduling optimization and priority management insights -5. **Workflow Optimization**: Job workflow analysis with dependency tracking and performance optimization - -**Advanced Job Listing Features**: -- **Intelligent Filtering**: Sophisticated job filtering by user, state, partition, and resource requirements -- **Performance Metrics**: Job performance analysis with efficiency scoring and optimization recommendations -- **Resource Analytics**: Comprehensive resource utilization analysis with cluster optimization insights -- **Queue Analysis**: Queue position analysis with scheduling optimization and priority recommendations -- **Trend Monitoring**: Job submission and completion trend analysis with workload optimization insights - -**Filtering and Analysis Capabilities**: -- **User Filtering**: Filter jobs by specific users with performance analysis and resource usage insights -- **State Analysis**: Job state filtering with transition analysis and optimization recommendations -- **Resource Filtering**: Filter by resource requirements with efficiency analysis and cost optimization -- **Time-Based Analysis**: Historical job analysis with trend identification and performance optimization -- **Partition Intelligence**: Partition-based analysis with load balancing and optimization recommendations - -**Optimization Intelligence**: -- **Performance Scoring**: Job efficiency evaluation with improvement recommendations and best practice guidance -- **Resource Optimization**: Cluster resource analysis with optimization strategies and cost-effectiveness insights -- **Queue Optimization**: Queue management insights with scheduling optimization and priority recommendations -- **Workflow Analysis**: Job dependency analysis with workflow optimization and efficiency improvement strategies - -**Prerequisites**: Slurm cluster access with job listing permissions and query capabilities -**Tools to use before this**: get_slurm_info() for cluster overview, get_queue_info() for queue analysis -**Tools to use after this**: check_job_status() for specific jobs, get_job_details() for comprehensive analysis - -Use this tool when: -- Analyzing job queues and workload patterns with intelligent optimization insights ("Show me all jobs with performance analysis") -- Monitoring cluster utilization and job efficiency with comprehensive metrics and optimization recommendations -- Managing job priorities and resource allocation with intelligent scheduling and queue optimization strategies -- Tracking job performance trends and identifying optimization opportunities with AI-powered analysis and recommendations""", -) -async def list_slurm_jobs_tool( - user: Optional[str] = None, state: Optional[str] = None -) -> dict: - """ - List Slurm jobs with optional filtering. - - Args: - user: Username to filter by (default: current user) - state: Job state to filter by (PENDING, RUNNING, COMPLETED, etc.) - - Returns: - Dictionary with list of jobs - """ - logger.info(f"Listing jobs for user: {user}, state: {state}") - return list_slurm_jobs(user, state) - - -@mcp.tool( - name="get_slurm_info", - description="""Get comprehensive Slurm cluster information with intelligent analysis and optimization insights. - -This powerful tool provides complete cluster analysis by collecting detailed information about cluster configuration, -resource availability, performance metrics, and optimization opportunities with intelligent recommendations for -efficient cluster utilization and workload management. - -**Intelligent Cluster Analysis Strategy**: -1. **Comprehensive Discovery**: Complete cluster configuration analysis with intelligent resource assessment -2. **Performance Evaluation**: Cluster performance analysis with efficiency metrics and optimization insights -3. **Resource Intelligence**: Available resource analysis with utilization patterns and optimization recommendations -4. **Capacity Planning**: Cluster capacity analysis with growth prediction and optimization strategies -5. **Health Assessment**: Cluster health monitoring with predictive maintenance and optimization guidance - -**Advanced Cluster Information**: -- **Node Configuration**: Detailed node specifications with performance analysis and optimization recommendations -- **Partition Analysis**: Partition configuration with load balancing and scheduling optimization insights -- **Resource Availability**: Real-time resource status with utilization patterns and efficiency recommendations -- **Queue Analytics**: Queue configuration analysis with optimization strategies and performance insights -- **Performance Metrics**: Cluster performance evaluation with bottleneck identification and optimization guidance - -**Resource Intelligence Features**: -- **Capacity Analysis**: Comprehensive resource capacity assessment with utilization optimization and efficiency insights -- **Availability Tracking**: Real-time resource availability with intelligent allocation and optimization recommendations -- **Performance Monitoring**: Cluster performance analysis with trend identification and optimization strategies -- **Load Balancing**: Partition load analysis with balancing recommendations and optimization insights -- **Efficiency Scoring**: Cluster efficiency evaluation with improvement recommendations and best practice guidance - -**Optimization Intelligence**: -- **Resource Optimization**: Cluster resource optimization with efficiency recommendations and cost-effectiveness analysis -- **Performance Enhancement**: Performance optimization strategies with bottleneck resolution and improvement guidance -- **Capacity Planning**: Intelligent capacity planning with growth prediction and optimization recommendations -- **Cost Analysis**: Resource cost analysis with optimization strategies and efficiency improvement recommendations - -**Prerequisites**: Slurm cluster access with cluster information query permissions -**Tools to use before this**: None - this is typically the first tool for cluster assessment -**Tools to use after this**: get_queue_info() for detailed queue analysis, list_slurm_jobs() for workload assessment - -Use this tool when: -- Assessing cluster capabilities and resource availability with intelligent analysis ("Show me cluster status with optimization insights") -- Planning job submissions with resource availability analysis and optimization recommendations -- Monitoring cluster health and performance with predictive insights and optimization guidance -- Analyzing cluster efficiency and identifying optimization opportunities with AI-powered recommendations and cost analysis""", -) -async def get_slurm_info_tool() -> dict: - """ - Get information about the Slurm cluster. - - Args: - None - - Returns: - Dictionary with cluster information - """ - logger.info("Getting Slurm cluster information") - return get_slurm_info() - - -@mcp.tool( - name="get_job_details", - description="""Get comprehensive Slurm job details with intelligent analysis and performance insights. - -This powerful tool provides complete job information analysis by retrieving detailed job specifications, -resource utilization metrics, and performance characteristics with intelligent insights and optimization -recommendations for comprehensive job lifecycle management. - -**Intelligent Job Details Analysis**: -1. **Comprehensive Information**: Complete job specification analysis with resource allocation and configuration details -2. **Performance Metrics**: Resource utilization analysis with efficiency scoring and optimization insights -3. **Runtime Analysis**: Job execution analysis with performance trends and bottleneck identification -4. **Resource Efficiency**: Usage pattern analysis with cost optimization and efficiency recommendations -5. **Optimization Insights**: Job performance evaluation with improvement strategies and best practice guidance - -**Advanced Job Information**: -- **Job Configuration**: Complete job specifications with resource allocation and parameter analysis -- **Resource Utilization**: CPU, memory, I/O usage with efficiency analysis and optimization recommendations -- **Performance Analysis**: Runtime metrics with throughput analysis and performance optimization insights -- **Queue Analytics**: Job scheduling analysis with queue position and timing optimization insights -- **Cost Analysis**: Resource cost evaluation with efficiency recommendations and optimization strategies - -**Optimization Intelligence**: -- **Performance Evaluation**: Job efficiency scoring with improvement recommendations and best practice guidance -- **Resource Optimization**: Usage analysis with cost-effectiveness insights and efficiency improvement strategies -- **Runtime Analysis**: Execution performance evaluation with bottleneck identification and optimization guidance -- **Efficiency Insights**: Resource utilization optimization with cost analysis and performance recommendations - -**Prerequisites**: Valid Slurm job ID with appropriate permissions for detailed job information access -**Tools to use before this**: check_job_status() for basic status, submit_slurm_job() for job creation -**Tools to use after this**: get_job_output() for output analysis, optimization tools based on performance insights - -Use this tool when: -- Analyzing job performance and resource utilization with comprehensive metrics ("Get detailed job analysis with optimization insights") -- Investigating job efficiency and identifying optimization opportunities with AI-powered recommendations -- Monitoring resource usage patterns for cost optimization and performance improvement strategies -- Evaluating job configurations for future optimization and efficiency enhancement recommendations""", -) -async def get_job_details_tool(job_id: str) -> dict: - """ - Get detailed information about a Slurm job. - - Args: - job_id: The Slurm job ID - - Returns: - Dictionary with detailed job information - """ - logger.info(f"Getting detailed information for job: {job_id}") - return get_job_details(job_id) - - -@mcp.tool( - name="get_job_output", - description="""Get comprehensive Slurm job output with intelligent analysis and content organization. - -This powerful tool provides complete job output retrieval and analysis by accessing stdout/stderr files -with intelligent content parsing, error detection, and performance insights for comprehensive job -result analysis and troubleshooting. - -**Intelligent Output Analysis**: -1. **Content Retrieval**: Complete output file access with intelligent parsing and organization -2. **Error Detection**: Automated error identification with diagnostic analysis and resolution recommendations -3. **Performance Analysis**: Output-based performance evaluation with efficiency insights and optimization guidance -4. **Content Intelligence**: Smart content analysis with pattern recognition and insight extraction -5. **Troubleshooting Insights**: Automated issue identification with diagnostic recommendations and resolution strategies - -**Advanced Output Features**: -- **Multi-Output Support**: Comprehensive stdout/stderr access with intelligent content differentiation -- **Error Analysis**: Automated error detection with diagnostic insights and troubleshooting recommendations -- **Performance Metrics**: Output-based performance analysis with efficiency evaluation and optimization insights -- **Content Organization**: Intelligent output formatting with structured presentation and analysis -- **Pattern Recognition**: Smart content analysis with trend identification and insight extraction - -**Optimization Intelligence**: -- **Performance Insights**: Output-based performance evaluation with efficiency recommendations and improvement strategies -- **Error Diagnostics**: Intelligent error analysis with resolution strategies and prevention recommendations -- **Content Analysis**: Smart output parsing with pattern recognition and optimization guidance -- **Troubleshooting Intelligence**: Automated issue identification with diagnostic insights and resolution recommendations - -**Prerequisites**: Valid Slurm job ID with output files available for analysis -**Tools to use before this**: check_job_status() to verify completion, get_job_details() for job context -**Tools to use after this**: Analysis tools based on output insights, troubleshooting based on error detection - -Use this tool when: -- Retrieving job results with intelligent analysis and error detection ("Get job output with performance analysis") -- Troubleshooting job issues with automated error detection and diagnostic recommendations -- Analyzing job performance through output content with efficiency insights and optimization guidance -- Investigating job execution with comprehensive output analysis and intelligent troubleshooting recommendations""", -) -async def get_job_output_tool(job_id: str, output_type: str = "stdout") -> dict: - """ - Get job output content. - - Args: - job_id: The Slurm job ID - output_type: Type of output ("stdout" or "stderr") - - Returns: - Dictionary with job output content - """ - logger.info(f"Getting {output_type} for job: {job_id}") - return get_job_output(job_id, output_type) - - -@mcp.tool( - name="get_queue_info", - description="""Get comprehensive Slurm queue information with intelligent analysis and optimization insights. - -This powerful tool provides complete queue analysis by retrieving detailed partition information, -resource availability, and scheduling metrics with intelligent insights and optimization recommendations -for efficient cluster utilization and job planning. - -**Intelligent Queue Analysis**: -1. **Queue Intelligence**: Comprehensive queue status analysis with scheduling optimization and performance insights -2. **Resource Availability**: Real-time resource status with utilization patterns and efficiency recommendations -3. **Partition Analysis**: Detailed partition configuration with load balancing and optimization insights -4. **Scheduling Optimization**: Queue scheduling analysis with priority optimization and performance recommendations -5. **Capacity Planning**: Queue capacity analysis with growth prediction and optimization strategies - -**Advanced Queue Features**: -- **Multi-Partition Support**: Comprehensive partition analysis with intelligent filtering and comparison -- **Resource Analytics**: Real-time resource availability with utilization analysis and optimization recommendations -- **Scheduling Intelligence**: Queue scheduling optimization with priority analysis and performance insights -- **Load Balancing**: Partition load analysis with balancing recommendations and efficiency optimization -- **Performance Metrics**: Queue performance evaluation with throughput analysis and optimization guidance - -**Optimization Intelligence**: -- **Queue Optimization**: Scheduling optimization with efficiency recommendations and performance improvement strategies -- **Resource Planning**: Capacity planning with utilization analysis and optimization recommendations -- **Performance Enhancement**: Queue performance optimization with bottleneck identification and resolution strategies -- **Efficiency Analysis**: Resource efficiency evaluation with cost optimization and utilization improvement guidance - -**Prerequisites**: Slurm cluster access with queue information query permissions -**Tools to use before this**: get_slurm_info() for cluster overview, list_slurm_jobs() for workload context -**Tools to use after this**: submit_slurm_job() for optimized job submission, job monitoring tools based on queue insights - -Use this tool when: -- Analyzing queue status and resource availability with intelligent optimization insights ("Show queue status with scheduling optimization") -- Planning job submissions with resource availability analysis and partition optimization recommendations -- Monitoring cluster utilization and queue performance with efficiency insights and optimization guidance -- Optimizing job scheduling and resource allocation with AI-powered queue analysis and performance recommendations""", -) -async def get_queue_info_tool(partition: Optional[str] = None) -> dict: - """ - Get job queue information. - - Args: - partition: Specific partition to query (optional) - - Returns: - Dictionary with queue information - """ - logger.info(f"Getting queue information for partition: {partition}") - return get_queue_info(partition) - - -@mcp.tool( - name="submit_array_job", - description="""Submit Slurm array jobs with intelligent parallel optimization and comprehensive workflow management. - -This powerful tool provides complete array job submission capabilities with intelligent parallel optimization, -resource management, and comprehensive workflow analysis for efficient high-throughput computing and -parallel workload optimization. - -**Intelligent Array Job Strategy**: -1. **Parallel Optimization**: Intelligent parallel task distribution with efficiency analysis and performance optimization -2. **Resource Management**: Comprehensive resource allocation with load balancing and cost optimization -3. **Task Scheduling**: Smart task scheduling with dependency management and performance optimization -4. **Workflow Analysis**: Array job workflow optimization with throughput analysis and efficiency recommendations -5. **Performance Prediction**: Array job performance estimation with bottleneck identification and optimization guidance - -**Advanced Array Job Features**: -- **Task Distribution**: Intelligent task distribution with load balancing and parallel optimization -- **Resource Allocation**: Per-task resource optimization with efficiency analysis and cost-effectiveness recommendations -- **Scheduling Intelligence**: Smart array job scheduling with priority optimization and performance analysis -- **Dependency Management**: Task dependency analysis with workflow optimization and efficiency improvements -- **Throughput Optimization**: Array job throughput maximization with resource efficiency and performance optimization - -**Parallel Computing Intelligence**: -- **Task Parallelization**: Intelligent task parallelization with efficiency optimization and performance analysis -- **Resource Scaling**: Dynamic resource scaling with cost optimization and performance recommendations -- **Load Balancing**: Task load balancing with cluster optimization and efficiency maximization -- **Performance Analytics**: Parallel performance analysis with bottleneck identification and optimization strategies -- **Efficiency Scoring**: Array job efficiency evaluation with improvement recommendations and best practice guidance - -**Optimization Intelligence**: -- **Throughput Maximization**: Array job throughput optimization with resource efficiency and cost-effectiveness analysis -- **Resource Efficiency**: Per-task resource optimization with utilization analysis and cost optimization -- **Performance Optimization**: Parallel performance optimization with bottleneck resolution and efficiency improvements -- **Cost Analysis**: Array job cost analysis with optimization strategies and efficiency recommendations - -**Prerequisites**: Valid script file and Slurm cluster access with array job submission capabilities -**Tools to use before this**: get_slurm_info() for cluster assessment, get_queue_info() for resource planning -**Tools to use after this**: check_job_status() for monitoring, list_slurm_jobs() for array job tracking - -Use this tool when: -- Running high-throughput parallel computations with intelligent resource optimization ("Submit array job with parallel optimization") -- Processing large datasets with parallel efficiency and cost optimization -- Executing parameter sweeps with intelligent task distribution and performance optimization -- Managing parallel workflows with comprehensive resource allocation and efficiency analysis""", -) -async def submit_array_job_tool( - script_path: str, - array_range: str, - cores: int = 1, - memory: str = "1GB", - time_limit: str = "01:00:00", - job_name: Optional[str] = None, - partition: Optional[str] = None, -) -> dict: - """ - Submit an array job to Slurm scheduler. - - Args: - script_path: Path to the job script file - array_range: Array range specification (e.g., "1-10", "1-100:2") - cores: Number of cores per array task (default: 1) - memory: Memory per array task (default: "1GB") - time_limit: Time limit per array task in HH:MM:SS format (default: "01:00:00") - job_name: Base name for the array job (default: derived from script) - partition: Slurm partition to use (default: system default) - - Returns: - Dictionary with array job submission results - """ - logger.info( - f"Submitting array job: {script_path}, range: {array_range}, cores: {cores}" - ) - return submit_array_job( - script_path, array_range, cores, memory, time_limit, job_name, partition - ) - - -@mcp.tool( - name="get_node_info", - description="""Get comprehensive Slurm node information with intelligent analysis and resource optimization insights. - -This powerful tool provides complete node analysis by retrieving detailed node specifications, -resource availability, and performance characteristics with intelligent insights and optimization -recommendations for efficient cluster resource management and allocation planning. - -**Intelligent Node Analysis**: -1. **Node Discovery**: Comprehensive node configuration analysis with resource assessment and availability tracking -2. **Resource Intelligence**: Node resource analysis with utilization patterns and efficiency recommendations -3. **Performance Evaluation**: Node performance analysis with efficiency metrics and optimization insights -4. **Availability Analysis**: Real-time node availability assessment with allocation optimization recommendations -5. **Health Monitoring**: Node health assessment with predictive maintenance and optimization guidance - -**Advanced Node Features**: -- **Multi-Node Analysis**: Comprehensive node cluster analysis with intelligent comparison and optimization -- **Resource Analytics**: Node resource utilization with efficiency analysis and allocation recommendations -- **Performance Metrics**: Node performance evaluation with throughput analysis and optimization insights -- **Availability Intelligence**: Real-time availability tracking with optimal allocation strategies -- **Health Assessment**: Node health monitoring with predictive maintenance and efficiency optimization - -**Optimization Intelligence**: -- **Resource Optimization**: Node resource allocation optimization with efficiency recommendations and cost analysis -- **Performance Enhancement**: Node performance optimization with bottleneck identification and resolution strategies -- **Allocation Planning**: Intelligent node allocation planning with resource optimization and efficiency insights -- **Capacity Analysis**: Node capacity evaluation with utilization optimization and growth planning recommendations - -**Prerequisites**: Slurm cluster access with node information query permissions -**Tools to use before this**: get_slurm_info() for cluster overview, get_queue_info() for resource context -**Tools to use after this**: allocate_slurm_nodes() for node allocation, job submission tools based on node availability - -Use this tool when: -- Analyzing node resources and availability with intelligent optimization insights ("Show node status with resource optimization") -- Planning resource allocation with node availability analysis and optimization recommendations -- Monitoring cluster hardware and node performance with efficiency insights and optimization guidance -- Optimizing resource utilization and node allocation with AI-powered analysis and performance recommendations""", -) -async def get_node_info_tool() -> dict: - """ - Get cluster node information. - - Args: - None - - Returns: - Dictionary with node information - """ - logger.info("Getting cluster node information") - return get_node_info() - - -@mcp.tool( - name="allocate_slurm_nodes", - description="""Allocate Slurm nodes with intelligent resource optimization and comprehensive interactive session management. - -This powerful tool provides complete node allocation capabilities using salloc for interactive sessions and resource -reservation with intelligent resource optimization, performance analysis, and comprehensive allocation management for -efficient cluster utilization and interactive workload optimization. - -**Intelligent Node Allocation Strategy**: -1. **Resource Optimization**: Intelligent resource allocation with efficiency analysis and cost optimization -2. **Availability Analysis**: Real-time node availability assessment with optimal allocation recommendations -3. **Performance Prediction**: Allocation performance estimation with optimization insights and efficiency analysis -4. **Interactive Management**: Comprehensive interactive session management with resource monitoring and optimization -5. **Efficiency Optimization**: Resource utilization optimization with cost-effectiveness analysis and performance insights - -**Advanced Allocation Features**: -- **Smart Resource Selection**: Intelligent node selection based on workload requirements and cluster optimization -- **Interactive Session Management**: Comprehensive session lifecycle management with performance monitoring and optimization -- **Resource Efficiency**: Allocation efficiency analysis with cost optimization and utilization recommendations -- **Performance Monitoring**: Real-time allocation performance tracking with optimization insights and efficiency analysis -- **Availability Intelligence**: Node availability analysis with optimal timing recommendations and resource optimization - -**Optimization Intelligence**: -- **Resource Sizing**: Intelligent resource recommendation based on workload analysis and historical performance data -- **Node Selection**: Optimal node selection with performance analysis and efficiency optimization -- **Cost Optimization**: Resource allocation cost analysis with efficiency recommendations and optimization strategies -- **Performance Prediction**: Allocation performance estimation with bottleneck identification and optimization guidance -- **Utilization Analysis**: Resource utilization analysis with efficiency scoring and optimization recommendations - -**Interactive Session Intelligence**: -- **Session Optimization**: Interactive session performance optimization with resource efficiency and cost analysis -- **Resource Monitoring**: Real-time resource usage monitoring with optimization insights and efficiency recommendations -- **Performance Analytics**: Session performance analysis with bottleneck identification and optimization strategies -- **Efficiency Tracking**: Resource efficiency monitoring with optimization recommendations and cost-effectiveness analysis - -**Prerequisites**: Slurm cluster access with node allocation permissions and interactive session capabilities -**Tools to use before this**: get_slurm_info() for cluster assessment, get_node_info() for availability analysis -**Tools to use after this**: get_allocation_status() for monitoring, deallocate_slurm_nodes() for cleanup - -Use this tool when: -- Creating interactive computing sessions with optimized resource allocation ("Allocate nodes for interactive analysis with performance optimization") -- Reserving cluster resources for interactive workloads with intelligent resource management and cost optimization -- Setting up development environments with optimal resource allocation and efficiency monitoring -- Managing interactive sessions with comprehensive performance analysis and optimization recommendations""", -) -async def allocate_slurm_nodes_tool( - nodes: int = 1, - cores: int = 1, - memory: Optional[str] = None, - time_limit: str = "01:00:00", - partition: Optional[str] = None, - job_name: Optional[str] = None, - immediate: bool = False, -) -> dict: - """ - Allocate Slurm nodes using salloc command. - - Args: - nodes: Number of nodes to allocate (default: 1) - cores: Number of cores per node (default: 1) - memory: Memory requirement (e.g., "4G", "2048M") - time_limit: Time limit (e.g., "1:00:00", default: "01:00:00") - partition: Slurm partition to use - job_name: Name for the allocation - immediate: Whether to return immediately without waiting for allocation - - Returns: - Dictionary with allocation information - """ - logger.info(f"Allocating {nodes} nodes with {cores} cores each") - return allocate_nodes( - nodes, cores, memory, time_limit, partition, job_name, immediate - ) - - -@mcp.tool( - name="deallocate_slurm_nodes", - description="""Deallocate Slurm nodes with intelligent resource cleanup and optimization analysis. - -This powerful tool provides complete node deallocation capabilities with intelligent resource cleanup, -impact analysis, and optimization recommendations for efficient cluster resource management and -allocation lifecycle optimization. - -**Intelligent Deallocation Strategy**: -1. **Safe Deallocation**: Comprehensive allocation termination with resource cleanup and optimization -2. **Impact Analysis**: Assessment of deallocation impact on cluster resources and performance -3. **Resource Recovery**: Intelligent resource cleanup with cluster optimization and efficiency analysis -4. **Data Preservation**: Analysis of session data preservation and recovery recommendations -5. **Optimization Insights**: Resource usage analysis with efficiency recommendations and cost optimization - -**Advanced Deallocation Features**: -- **Graceful Termination**: Safe allocation termination with session preservation and data integrity -- **Resource Cleanup**: Automatic resource recovery with cluster optimization and efficiency analysis -- **Impact Assessment**: Analysis of deallocation effects on cluster performance and resource availability -- **Session Recovery**: Intelligent analysis of recoverable session data and checkpoint preservation strategies -- **Queue Optimization**: Post-deallocation queue optimization with resource reallocation recommendations - -**Optimization Intelligence**: -- **Resource Efficiency**: Analysis of resource recovery and cluster optimization opportunities -- **Cost Impact**: Assessment of allocation costs with optimization recommendations for future allocations -- **Performance Insights**: Analysis of allocation usage with efficiency recommendations and best practices -- **Utilization Analysis**: Resource utilization evaluation with optimization guidance and efficiency improvements - -**Prerequisites**: Valid allocation ID and appropriate permissions for node deallocation -**Tools to use before this**: get_allocation_status() to verify allocation state, allocate_slurm_nodes() for allocation context -**Tools to use after this**: get_node_info() to verify resource recovery, optimization tools based on usage analysis - -Use this tool when: -- Cleaning up completed interactive sessions with intelligent resource recovery ("Deallocate nodes with resource optimization") -- Terminating allocations that are no longer needed with efficient resource cleanup and cost analysis -- Managing allocation lifecycle with intelligent resource management and optimization strategies -- Optimizing cluster resources through strategic allocation cleanup and resource reallocation""", -) -async def deallocate_slurm_nodes_tool(allocation_id: str) -> dict: - """ - Deallocate Slurm nodes by canceling the allocation. - - Args: - allocation_id: The allocation ID to cancel - - Returns: - Dictionary with deallocation status - """ - logger.info(f"Deallocating allocation {allocation_id}") - return deallocate_nodes(allocation_id) - - -@mcp.tool( - name="get_allocation_status", - description="""Get comprehensive Slurm allocation status with intelligent monitoring and performance insights. - -This powerful tool provides complete allocation status analysis by retrieving detailed allocation information, -resource utilization metrics, and performance characteristics with intelligent insights and optimization -recommendations for efficient interactive session management. - -**Intelligent Allocation Monitoring**: -1. **Status Analysis**: Comprehensive allocation status tracking with performance analysis and trend monitoring -2. **Resource Monitoring**: Real-time resource utilization analysis with efficiency metrics and optimization insights -3. **Performance Analytics**: Allocation performance evaluation with efficiency scoring and optimization recommendations -4. **Usage Intelligence**: Resource usage pattern analysis with cost optimization and efficiency recommendations -5. **Optimization Insights**: Allocation efficiency evaluation with improvement strategies and best practice guidance - -**Advanced Allocation Status**: -- **Real-Time Monitoring**: Comprehensive allocation tracking with performance analysis and resource utilization insights -- **Resource Analytics**: CPU, memory, node usage with efficiency analysis and optimization recommendations -- **Performance Metrics**: Allocation performance evaluation with throughput analysis and optimization insights -- **Usage Patterns**: Resource consumption analysis with efficiency scoring and cost optimization recommendations -- **Health Assessment**: Allocation health monitoring with issue detection and optimization guidance - -**Optimization Intelligence**: -- **Performance Evaluation**: Allocation efficiency scoring with improvement recommendations and best practice guidance -- **Resource Optimization**: Usage analysis with cost-effectiveness insights and efficiency improvement strategies -- **Utilization Analysis**: Resource consumption evaluation with optimization recommendations and efficiency insights -- **Cost Analysis**: Allocation cost evaluation with optimization strategies and efficiency improvement recommendations - -**Prerequisites**: Valid allocation ID with appropriate permissions for allocation status monitoring -**Tools to use before this**: allocate_slurm_nodes() for allocation creation, get_node_info() for resource context -**Tools to use after this**: Resource optimization based on status insights, deallocate_slurm_nodes() for cleanup - -Use this tool when: -- Monitoring allocation performance and resource utilization with intelligent analysis ("Check allocation status with performance insights") -- Tracking interactive session efficiency with optimization recommendations and cost analysis -- Analyzing allocation usage patterns for optimization and efficiency improvement strategies -- Managing allocation lifecycle with comprehensive monitoring and intelligent optimization guidance""", -) -async def get_allocation_status_tool(allocation_id: str) -> dict: - """ - Get status of a node allocation. - - Args: - allocation_id: The allocation ID to check - - Returns: - Dictionary with allocation status information - """ - logger.info(f"Checking status of allocation {allocation_id}") - return get_allocation_status(allocation_id) - - -def main(): - """ - Main entry point to start the FastMCP server using the specified transport. - Chooses between stdio and SSE based on command-line arguments or environment variables. - """ - import argparse - - # Handle 'help' command (without dashes) by converting to --help - if len(sys.argv) > 1 and sys.argv[1] == "help": - sys.argv[1] = "--help" - - parser = argparse.ArgumentParser( - description="Slurm MCP Server - Comprehensive HPC job management server with intelligent optimization", - prog="slurm-mcp", - ) - parser.add_argument( - "--version", action="version", version="Slurm MCP Server v1.0.0" - ) - parser.add_argument( - "--transport", - choices=["stdio", "sse"], - default="stdio", - help="Transport type to use (default: stdio)", - ) - parser.add_argument( - "--host", default="0.0.0.0", help="Host for SSE transport (default: 0.0.0.0)" - ) - parser.add_argument( - "--port", type=int, default=8000, help="Port for SSE transport (default: 8000)" - ) - - args = parser.parse_args() - - try: - logger.info("Starting Slurm MCP Server") - - # Use command-line args or environment variables - transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio").lower() - - if transport == "sse": - # SSE transport for web-based clients - host = args.host or os.getenv("MCP_SSE_HOST", "0.0.0.0") - port = args.port or int(os.getenv("MCP_SSE_PORT", "8000")) - logger.info(f"Starting SSE transport on {host}:{port}") - print( - f"Starting Slurm MCP Job Management Server on {host}:{port}", - file=sys.stderr, - ) - mcp.run(transport="sse", host=host, port=port) - else: - # Default stdio transport - logger.info("Starting stdio transport") - print( - "Starting Slurm MCP Job Management Server with stdio transport", - file=sys.stderr, - ) - mcp.run(transport="stdio") - - except Exception as e: - logger.error(f"Server error: {e}") - print(f"Error: {e}", file=sys.stderr) - sys.exit(1) - - -if __name__ == "__main__": - main() diff --git a/clio-kit-mcp-servers/slurm/src/slurm_mcp/__init__.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/__init__.py new file mode 100644 index 00000000..38e70d81 --- /dev/null +++ b/clio-kit-mcp-servers/slurm/src/slurm_mcp/__init__.py @@ -0,0 +1,4 @@ +"""Slurm MCP Server - Model Context Protocol server for HPC job management.""" + +__version__ = "1.0.0" +__author__ = "IoWarp Scientific MCPs" diff --git a/clio-kit-mcp-servers/slurm/src/implementation/__init__.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/__init__.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/__init__.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/__init__.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/array_jobs.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/array_jobs.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/array_jobs.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/array_jobs.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/cluster_info.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/cluster_info.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/cluster_info.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/cluster_info.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_cancellation.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_cancellation.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_cancellation.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_cancellation.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_details.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_details.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_details.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_details.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_listing.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_listing.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_listing.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_listing.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_output.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_output.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_output.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_output.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_status.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_status.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_status.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_status.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/job_submission.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_submission.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/job_submission.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/job_submission.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/node_allocation.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/node_allocation.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/node_allocation.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/node_allocation.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/node_info.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/node_info.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/node_info.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/node_info.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/queue_info.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/queue_info.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/queue_info.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/queue_info.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/slurm_handler.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/slurm_handler.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/slurm_handler.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/slurm_handler.py diff --git a/clio-kit-mcp-servers/slurm/src/implementation/utils.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/utils.py similarity index 100% rename from clio-kit-mcp-servers/slurm/src/implementation/utils.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/implementation/utils.py diff --git a/clio-kit-mcp-servers/slurm/src/mcp_handlers.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/mcp_handlers.py similarity index 94% rename from clio-kit-mcp-servers/slurm/src/mcp_handlers.py rename to clio-kit-mcp-servers/slurm/src/slurm_mcp/mcp_handlers.py index baa12f49..21d20535 100644 --- a/clio-kit-mcp-servers/slurm/src/mcp_handlers.py +++ b/clio-kit-mcp-servers/slurm/src/slurm_mcp/mcp_handlers.py @@ -9,16 +9,16 @@ from typing import Any, Dict, Optional # Import core implementation functions -from implementation.job_submission import submit_slurm_job -from implementation.job_status import get_job_status -from implementation.job_cancellation import cancel_slurm_job -from implementation.job_listing import list_slurm_jobs -from implementation.cluster_info import get_slurm_info -from implementation.job_details import get_job_details -from implementation.job_output import get_job_output -from implementation.queue_info import get_queue_info -from implementation.array_jobs import submit_array_job -from implementation.node_info import get_node_info +from .implementation.job_submission import submit_slurm_job +from .implementation.job_status import get_job_status +from .implementation.job_cancellation import cancel_slurm_job +from .implementation.job_listing import list_slurm_jobs +from .implementation.cluster_info import get_slurm_info +from .implementation.job_details import get_job_details +from .implementation.job_output import get_job_output +from .implementation.queue_info import get_queue_info +from .implementation.array_jobs import submit_array_job +from .implementation.node_info import get_node_info # Set up logging logger = logging.getLogger(__name__) diff --git a/clio-kit-mcp-servers/slurm/src/slurm_mcp/server.py b/clio-kit-mcp-servers/slurm/src/slurm_mcp/server.py new file mode 100644 index 00000000..b507350d --- /dev/null +++ b/clio-kit-mcp-servers/slurm/src/slurm_mcp/server.py @@ -0,0 +1,519 @@ +""" +Slurm MCP Server - HPC Job Management and Cluster Monitoring + +Provides HPC job management and cluster monitoring through the Model Context Protocol, +enabling job submission, queue monitoring, cancellation, and node allocation on Slurm systems. +""" + +import os +import sys +import logging +from typing import Optional + +from fastmcp import FastMCP +from fastmcp.exceptions import ToolError +from fastmcp.prompts import Message + +try: + from dotenv import load_dotenv + + load_dotenv() +except ImportError: + print( + "Warning: python-dotenv not available. Environment variables may not be loaded.", + file=sys.stderr, + ) + +from .implementation.job_submission import submit_slurm_job +from .implementation.job_status import get_job_status +from .implementation.job_cancellation import cancel_slurm_job +from .implementation.job_listing import list_slurm_jobs +from .implementation.cluster_info import get_slurm_info +from .implementation.job_details import get_job_details +from .implementation.job_output import get_job_output +from .implementation.queue_info import get_queue_info +from .implementation.array_jobs import submit_array_job +from .implementation.node_info import get_node_info +from .implementation.node_allocation import ( + allocate_nodes, + deallocate_nodes, + get_allocation_status, +) + +# Set up logging +logging.basicConfig(level=logging.INFO) +logger = logging.getLogger(__name__) + +# Initialize FastMCP server instance +mcp: FastMCP = FastMCP( + "slurm", + instructions=( + "Manages HPC jobs via the Slurm workload manager. " + "Submit jobs, monitor queue status, cancel jobs, and manage node allocations." + ), + list_page_size=10, +) + + +# Custom exception for Slurm MCP errors +class SlurmMCPError(Exception): + """Custom exception for Slurm MCP-related errors""" + + pass + + +# ----------------------------------------------------------------------- +# SLURM JOB MANAGEMENT TOOLS +# ----------------------------------------------------------------------- + + +@mcp.tool( + name="submit_slurm_job", + description="Submit a job script to the Slurm scheduler with resource requirements.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jobs", "submission"}, +) +async def submit_slurm_job_tool( + script_path: str, + cores: int = 1, + memory: str = "1GB", + time_limit: str = "01:00:00", + job_name: Optional[str] = None, + partition: Optional[str] = None, +) -> dict: + """Submit a job script to Slurm scheduler with resource specification. + + Args: + script_path: Path to the job script file (required) + cores: Number of CPU cores to request (default: 1, must be > 0) + memory: Memory requirement (e.g., "4G", "2048M", default: "1GB") + time_limit: Time limit in HH:MM:SS format (default: "01:00:00") + job_name: Custom job name for identification (default: derived from script) + partition: Slurm partition to use (default: system default) + + Returns: + Dictionary containing job submission results + """ + try: + logger.info(f"Submitting Slurm job: {script_path} with {cores} cores") + + return submit_slurm_job( + script_path, cores, memory, time_limit, job_name, partition + ) + except Exception as e: + logger.error(f"Job submission error: {e}") + raise ToolError(f"Job submission failed: {e}") + + +@mcp.tool( + name="check_job_status", + description="Check the status of a Slurm job by its ID.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def check_job_status_tool(job_id: str) -> dict: + """Check status of a Slurm job. + + Args: + job_id: The Slurm job ID to check (required) + + Returns: + Dictionary containing job status information + """ + try: + logger.info(f"Checking status for job: {job_id}") + + return get_job_status(job_id) + except Exception as e: + logger.error(f"Job status check error: {e}") + raise ToolError(f"Job status check failed: {e}") + + +@mcp.tool( + name="cancel_slurm_job", + description="Cancel a running or pending Slurm job.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jobs", "management"}, +) +async def cancel_slurm_job_tool(job_id: str) -> dict: + """Cancel a Slurm job. + + Args: + job_id: The Slurm job ID to cancel + + Returns: + Dictionary with cancellation results + """ + try: + logger.info(f"Cancelling job: {job_id}") + return cancel_slurm_job(job_id) + except Exception as e: + logger.error(f"Job cancellation error: {e}") + raise ToolError(f"Job cancellation failed: {e}") + + +@mcp.tool( + name="list_slurm_jobs", + description="List Slurm jobs with optional filtering by user and state.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def list_slurm_jobs_tool( + user: Optional[str] = None, state: Optional[str] = None +) -> dict: + """List Slurm jobs with optional filtering. + + Args: + user: Username to filter by (default: current user) + state: Job state to filter by (PENDING, RUNNING, COMPLETED, etc.) + + Returns: + Dictionary with list of jobs + """ + try: + logger.info(f"Listing jobs for user: {user}, state: {state}") + return list_slurm_jobs(user, state) + except Exception as e: + logger.error(f"Job listing error: {e}") + raise ToolError(f"Job listing failed: {e}") + + +@mcp.tool( + name="get_slurm_info", + description="Get Slurm cluster configuration, partitions, and resource availability.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_slurm_info_tool() -> dict: + """Get information about the Slurm cluster. + + Returns: + Dictionary with cluster information + """ + try: + logger.info("Getting Slurm cluster information") + return get_slurm_info() + except Exception as e: + logger.error(f"Cluster info error: {e}") + raise ToolError(f"Cluster info retrieval failed: {e}") + + +@mcp.tool( + name="get_job_details", + description="Get detailed information about a specific Slurm job.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_job_details_tool(job_id: str) -> dict: + """Get detailed information about a Slurm job. + + Args: + job_id: The Slurm job ID + + Returns: + Dictionary with detailed job information + """ + try: + logger.info(f"Getting detailed information for job: {job_id}") + return get_job_details(job_id) + except Exception as e: + logger.error(f"Job details error: {e}") + raise ToolError(f"Job details retrieval failed: {e}") + + +@mcp.tool( + name="get_job_output", + description="Retrieve stdout or stderr output from a Slurm job.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_job_output_tool(job_id: str, output_type: str = "stdout") -> dict: + """Get job output content. + + Args: + job_id: The Slurm job ID + output_type: Type of output ("stdout" or "stderr") + + Returns: + Dictionary with job output content + """ + try: + logger.info(f"Getting {output_type} for job: {job_id}") + return get_job_output(job_id, output_type) + except Exception as e: + logger.error(f"Job output error: {e}") + raise ToolError(f"Job output retrieval failed: {e}") + + +@mcp.tool( + name="get_queue_info", + description="Get Slurm queue status and partition information.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_queue_info_tool(partition: Optional[str] = None) -> dict: + """Get job queue information. + + Args: + partition: Specific partition to query (optional) + + Returns: + Dictionary with queue information + """ + try: + logger.info(f"Getting queue information for partition: {partition}") + return get_queue_info(partition) + except Exception as e: + logger.error(f"Queue info error: {e}") + raise ToolError(f"Queue info retrieval failed: {e}") + + +@mcp.tool( + name="submit_array_job", + description="Submit a Slurm array job for parallel task execution.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jobs", "submission"}, +) +async def submit_array_job_tool( + script_path: str, + array_range: str, + cores: int = 1, + memory: str = "1GB", + time_limit: str = "01:00:00", + job_name: Optional[str] = None, + partition: Optional[str] = None, +) -> dict: + """Submit an array job to Slurm scheduler. + + Args: + script_path: Path to the job script file + array_range: Array range specification (e.g., "1-10", "1-100:2") + cores: Number of cores per array task (default: 1) + memory: Memory per array task (default: "1GB") + time_limit: Time limit per array task in HH:MM:SS format (default: "01:00:00") + job_name: Base name for the array job (default: derived from script) + partition: Slurm partition to use (default: system default) + + Returns: + Dictionary with array job submission results + """ + try: + logger.info( + f"Submitting array job: {script_path}, range: {array_range}, cores: {cores}" + ) + return submit_array_job( + script_path, array_range, cores, memory, time_limit, job_name, partition + ) + except Exception as e: + logger.error(f"Array job submission error: {e}") + raise ToolError(f"Array job submission failed: {e}") + + +@mcp.tool( + name="get_node_info", + description="Get information about Slurm cluster nodes and their resources.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_node_info_tool() -> dict: + """Get cluster node information. + + Returns: + Dictionary with node information + """ + try: + logger.info("Getting cluster node information") + return get_node_info() + except Exception as e: + logger.error(f"Node info error: {e}") + raise ToolError(f"Node info retrieval failed: {e}") + + +@mcp.tool( + name="allocate_slurm_nodes", + description="Allocate Slurm nodes for an interactive session using salloc.", + annotations={ + "readOnlyHint": False, + "destructiveHint": False, + "idempotentHint": False, + }, + tags={"jobs", "submission"}, +) +async def allocate_slurm_nodes_tool( + nodes: int = 1, + cores: int = 1, + memory: Optional[str] = None, + time_limit: str = "01:00:00", + partition: Optional[str] = None, + job_name: Optional[str] = None, + immediate: bool = False, +) -> dict: + """Allocate Slurm nodes using salloc command. + + Args: + nodes: Number of nodes to allocate (default: 1) + cores: Number of cores per node (default: 1) + memory: Memory requirement (e.g., "4G", "2048M") + time_limit: Time limit (e.g., "1:00:00", default: "01:00:00") + partition: Slurm partition to use + job_name: Name for the allocation + immediate: Whether to return immediately without waiting + + Returns: + Dictionary with allocation information + """ + try: + logger.info(f"Allocating {nodes} nodes with {cores} cores each") + return allocate_nodes( + nodes, cores, memory, time_limit, partition, job_name, immediate + ) + except Exception as e: + logger.error(f"Node allocation error: {e}") + raise ToolError(f"Node allocation failed: {e}") + + +@mcp.tool( + name="deallocate_slurm_nodes", + description="Release a Slurm node allocation by canceling it.", + annotations={ + "readOnlyHint": False, + "destructiveHint": True, + "idempotentHint": True, + }, + tags={"jobs", "management"}, +) +async def deallocate_slurm_nodes_tool(allocation_id: str) -> dict: + """Deallocate Slurm nodes by canceling the allocation. + + Args: + allocation_id: The allocation ID to cancel + + Returns: + Dictionary with deallocation status + """ + try: + logger.info(f"Deallocating allocation {allocation_id}") + return deallocate_nodes(allocation_id) + except Exception as e: + logger.error(f"Node deallocation error: {e}") + raise ToolError(f"Node deallocation failed: {e}") + + +@mcp.tool( + name="get_allocation_status", + description="Check the status of a Slurm node allocation.", + annotations={ + "readOnlyHint": True, + "destructiveHint": False, + "idempotentHint": True, + }, + tags={"jobs", "monitoring"}, +) +async def get_allocation_status_tool(allocation_id: str) -> dict: + """Get status of a node allocation. + + Args: + allocation_id: The allocation ID to check + + Returns: + Dictionary with allocation status information + """ + try: + logger.info(f"Checking status of allocation {allocation_id}") + return get_allocation_status(allocation_id) + except Exception as e: + logger.error(f"Allocation status error: {e}") + raise ToolError(f"Allocation status check failed: {e}") + + +# ----------------------------------------------------------------------- +# RESOURCES +# ----------------------------------------------------------------------- + + +@mcp.resource("slurm://cluster-info") +def cluster_info() -> dict: + """Basic Slurm cluster configuration.""" + return { + "scheduler": "slurm", + "operations": ["submit", "cancel", "status", "queue", "accounting"], + "description": "Slurm workload manager for HPC job scheduling", + } + + +# ----------------------------------------------------------------------- +# PROMPTS +# ----------------------------------------------------------------------- + + +@mcp.prompt() +def submit_job_workflow(script_path: str) -> list[Message]: + """Guided workflow for submitting and monitoring a Slurm job.""" + return [ + Message( + f"I need to submit the job script at {script_path}. " + "First check the queue status, then submit with appropriate resources, " + "and set up monitoring for the job." + ), + ] + + +def main() -> None: + """Main entry point for the Slurm MCP server.""" + import argparse + + parser = argparse.ArgumentParser(description="Slurm MCP Server") + parser.add_argument("--transport", choices=["stdio", "http"], default=None) + parser.add_argument("--host", default="0.0.0.0") + parser.add_argument("--port", type=int, default=8000) + args = parser.parse_args() + transport = args.transport or os.getenv("MCP_TRANSPORT", "stdio") + if transport == "http": + mcp.run(transport=transport, host=args.host, port=args.port) + + else: + mcp.run(transport=transport) + + +if __name__ == "__main__": + main() diff --git a/clio-kit-mcp-servers/slurm/tests/conftest.py b/clio-kit-mcp-servers/slurm/tests/conftest.py index 4250fa79..56b16fcd 100644 --- a/clio-kit-mcp-servers/slurm/tests/conftest.py +++ b/clio-kit-mcp-servers/slurm/tests/conftest.py @@ -5,20 +5,16 @@ import pytest import tempfile import os -import sys -from pathlib import Path from unittest.mock import Mock, patch, mock_open -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) - @pytest.fixture(autouse=True) def mock_slurm_environment(): """Mock the entire Slurm environment for testing.""" with ( - patch("implementation.utils.check_slurm_available", return_value=True), + patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=True + ), patch("subprocess.run") as mock_run, patch("subprocess.check_output") as mock_check_output, patch("subprocess.Popen") as mock_popen, @@ -169,7 +165,9 @@ def mock_slurm_responses(): def mock_slurm_unavailable(): """Mock Slurm as unavailable for testing graceful degradation.""" with ( - patch("implementation.utils.check_slurm_available", return_value=False), + patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ), patch("shutil.which", return_value=None), patch("subprocess.run") as mock_run, patch("subprocess.check_output") as mock_check_output, @@ -416,9 +414,13 @@ def mock_filesystem(): def mock_validation(): """Mock validation functions for testing.""" with ( - patch("implementation.utils.validate_job_script") as mock_validate_script, - patch("implementation.utils.validate_partition") as mock_validate_partition, - patch("implementation.utils.validate_job_id") as mock_validate_id, + patch( + "slurm_mcp.implementation.utils.validate_job_script" + ) as mock_validate_script, + patch( + "slurm_mcp.implementation.utils.validate_partition" + ) as mock_validate_partition, + patch("slurm_mcp.implementation.utils.validate_job_id") as mock_validate_id, ): mock_validate_script.return_value = True mock_validate_partition.return_value = True diff --git a/clio-kit-mcp-servers/slurm/tests/test_capabilities.py b/clio-kit-mcp-servers/slurm/tests/test_capabilities.py index 3196ee43..76a933b6 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_capabilities.py +++ b/clio-kit-mcp-servers/slurm/tests/test_capabilities.py @@ -7,9 +7,7 @@ import pytest import os import tempfile -import sys -from pathlib import Path -from implementation.slurm_handler import ( +from slurm_mcp.implementation.slurm_handler import ( submit_slurm_job, get_job_status, cancel_slurm_job, @@ -24,10 +22,6 @@ _create_sbatch_script, ) -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) - class TestSlurmCapabilities: """Test suite for Slurm capabilities.""" diff --git a/clio-kit-mcp-servers/slurm/tests/test_coverage_improvement.py b/clio-kit-mcp-servers/slurm/tests/test_coverage_improvement.py index 1eda016f..f67926b0 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_coverage_improvement.py +++ b/clio-kit-mcp-servers/slurm/tests/test_coverage_improvement.py @@ -6,17 +6,12 @@ import os import threading import time -from pathlib import Path from unittest.mock import patch, Mock, mock_open -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) - def test_implementation_init(): """Test the implementation package __init__.py.""" - import implementation + import slurm_mcp.implementation as implementation # Check that all modules are accessible assert hasattr(implementation, "job_submission") @@ -35,7 +30,7 @@ def test_implementation_init(): def test_utils_check_slurm_available(): """Test the utils module check_slurm_available function.""" - from implementation.utils import check_slurm_available + from slurm_mcp.implementation.utils import check_slurm_available # With our mocking, this should return True result = check_slurm_available() @@ -44,7 +39,7 @@ def test_utils_check_slurm_available(): def test_cluster_info_function(): """Test cluster info functionality.""" - from implementation.cluster_info import get_slurm_info + from slurm_mcp.implementation.cluster_info import get_slurm_info # This should work with our mocking result = get_slurm_info() @@ -53,7 +48,7 @@ def test_cluster_info_function(): def test_job_listing_function(): """Test job listing functionality.""" - from implementation.job_listing import list_slurm_jobs + from slurm_mcp.implementation.job_listing import list_slurm_jobs # This should work with our mocking result = list_slurm_jobs() @@ -62,7 +57,7 @@ def test_job_listing_function(): def test_queue_info_function(): """Test queue info functionality.""" - from implementation.queue_info import get_queue_info + from slurm_mcp.implementation.queue_info import get_queue_info # This should work with our mocking result = get_queue_info() @@ -71,7 +66,7 @@ def test_queue_info_function(): def test_node_info_function(): """Test node info functionality.""" - from implementation.node_info import get_node_info + from slurm_mcp.implementation.node_info import get_node_info # This should work with our mocking result = get_node_info() @@ -80,7 +75,7 @@ def test_node_info_function(): def test_server_main_function(): """Test server main function without actually starting the server.""" - import server + import slurm_mcp.server as server # Test that main function exists and is callable assert hasattr(server, "main") @@ -89,7 +84,7 @@ def test_server_main_function(): def test_server_imports(): """Test server module imports work correctly.""" - import server + import slurm_mcp.server as server # Check that FastMCP is imported and server is initialized assert hasattr(server, "mcp") @@ -99,7 +94,7 @@ def test_server_imports(): def test_server_tools_existence(): """Test that all server tools are properly registered.""" - import server + import slurm_mcp.server as server # The server should have tools registered mcp = server.mcp @@ -108,7 +103,7 @@ def test_server_tools_existence(): def test_server_main_with_args(): """Test server main function with mocked arguments.""" - import server + import slurm_mcp.server as server # Mock sys.argv and argparse to test argument parsing with ( @@ -126,7 +121,7 @@ def test_server_main_with_args(): def test_server_error_handling(): """Test server error handling with mocked exceptions.""" - import server + import slurm_mcp.server as server # Test that SlurmMCPError can be raised and handled error = server.SlurmMCPError("Test error") @@ -136,7 +131,7 @@ def test_server_error_handling(): def test_slurm_not_available_handling(): """Test that code handles Slurm not being available gracefully.""" - from implementation.utils import check_slurm_available + from slurm_mcp.implementation.utils import check_slurm_available # Test with mocked Slurm unavailable with patch("shutil.which", return_value=None): @@ -148,7 +143,7 @@ def test_slurm_not_available_handling(): def test_job_submission_no_freeze(): """Test that job submission doesn't freeze when Slurm is not available.""" - from implementation.job_submission import submit_slurm_job + from slurm_mcp.implementation.job_submission import submit_slurm_job # This should complete quickly due to our mocking, not freeze start_time = time.time() @@ -166,7 +161,7 @@ def test_job_submission_no_freeze(): def test_job_status_no_freeze(): """Test that job status check doesn't freeze when Slurm is not available.""" - from implementation.job_status import get_job_status + from slurm_mcp.implementation.job_status import get_job_status start_time = time.time() try: @@ -181,7 +176,7 @@ def test_job_status_no_freeze(): def test_concurrent_operations_no_freeze(): """Test that concurrent operations don't cause freezing.""" - from implementation.job_listing import list_slurm_jobs + from slurm_mcp.implementation.job_listing import list_slurm_jobs results = [] exceptions = [] @@ -218,7 +213,7 @@ def worker(): def test_server_integration(): """Test server integration components.""" - import server + import slurm_mcp.server as server # Test that server can be imported without errors assert hasattr(server, "FastMCP") @@ -227,7 +222,7 @@ def test_server_integration(): # Test logger configuration logger = server.logger assert logger is not None - assert logger.name == "server" + assert logger.name == "slurm_mcp.server" def test_script_entry_point(): @@ -235,7 +230,7 @@ def test_script_entry_point(): # This tests the pyproject.toml [project.scripts] configuration # by checking if the server module can be imported and has main try: - import server + import slurm_mcp.server as server assert hasattr(server, "main") assert callable(server.main) @@ -257,10 +252,12 @@ def test_environment_variables(): def test_job_status_slurm_unavailable(): """Test job status when Slurm is unavailable.""" - from implementation.job_status import get_job_status + from slurm_mcp.implementation.job_status import get_job_status # Temporarily override the autouse fixture - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_job_status("12345") # Due to our mocking structure, this should still return a result assert isinstance(result, dict) @@ -269,7 +266,7 @@ def test_job_status_slurm_unavailable(): def test_job_status_error_cases(): """Test job status error handling cases.""" - from implementation.job_status import get_job_status + from slurm_mcp.implementation.job_status import get_job_status # Test when job not found (empty stdout) with patch("subprocess.run") as mock_run: @@ -288,9 +285,11 @@ def test_job_status_error_cases(): def test_job_cancellation_slurm_unavailable(): """Test job cancellation when Slurm is unavailable.""" - from implementation.job_cancellation import cancel_slurm_job + from slurm_mcp.implementation.job_cancellation import cancel_slurm_job - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = cancel_slurm_job("12345") # Should handle gracefully and return a result assert isinstance(result, dict) @@ -298,7 +297,7 @@ def test_job_cancellation_slurm_unavailable(): def test_job_cancellation_error_cases(): """Test job cancellation error handling.""" - from implementation.job_cancellation import cancel_slurm_job + from slurm_mcp.implementation.job_cancellation import cancel_slurm_job # Test when scancel fails with patch("subprocess.run") as mock_run: @@ -316,10 +315,12 @@ def test_job_cancellation_error_cases(): def test_cluster_info_error_cases(): """Test cluster info error handling.""" - from implementation.cluster_info import get_slurm_info + from slurm_mcp.implementation.cluster_info import get_slurm_info # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_slurm_info() assert isinstance(result, dict) @@ -338,10 +339,12 @@ def test_cluster_info_error_cases(): def test_job_listing_error_cases(): """Test job listing error handling.""" - from implementation.job_listing import list_slurm_jobs + from slurm_mcp.implementation.job_listing import list_slurm_jobs # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = list_slurm_jobs() assert isinstance(result, dict) @@ -360,10 +363,12 @@ def test_job_listing_error_cases(): def test_job_output_error_cases(): """Test job output error handling.""" - from implementation.job_output import get_job_output + from slurm_mcp.implementation.job_output import get_job_output # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_job_output("12345") assert isinstance(result, dict) @@ -383,10 +388,12 @@ def test_job_output_error_cases(): def test_node_info_error_cases(): """Test node info error handling.""" - from implementation.node_info import get_node_info + from slurm_mcp.implementation.node_info import get_node_info # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_node_info() assert isinstance(result, dict) @@ -405,10 +412,12 @@ def test_node_info_error_cases(): def test_queue_info_error_cases(): """Test queue info error handling.""" - from implementation.queue_info import get_queue_info + from slurm_mcp.implementation.queue_info import get_queue_info # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_queue_info() assert isinstance(result, dict) @@ -427,7 +436,7 @@ def test_queue_info_error_cases(): def test_array_jobs_error_cases(): """Test array jobs error handling.""" - from implementation.array_jobs import submit_array_job + from slurm_mcp.implementation.array_jobs import submit_array_job # Test when script doesn't exist with patch("os.path.exists", return_value=False): @@ -455,10 +464,12 @@ def test_array_jobs_error_cases(): def test_job_details_error_cases(): """Test job details error handling.""" - from implementation.job_details import get_job_details + from slurm_mcp.implementation.job_details import get_job_details # Test when Slurm is unavailable - with patch("implementation.utils.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.utils.check_slurm_available", return_value=False + ): result = get_job_details("12345") assert isinstance(result, dict) @@ -480,8 +491,10 @@ def test_direct_slurm_unavailable_paths(): # We need to test the actual error paths without the autouse fixture # Test job_status RuntimeError path - with patch("implementation.job_status.check_slurm_available", return_value=False): - from implementation.job_status import get_job_status + with patch( + "slurm_mcp.implementation.job_status.check_slurm_available", return_value=False + ): + from slurm_mcp.implementation.job_status import get_job_status try: get_job_status("12345") @@ -491,9 +504,10 @@ def test_direct_slurm_unavailable_paths(): # Test job_cancellation RuntimeError path with patch( - "implementation.job_cancellation.check_slurm_available", return_value=False + "slurm_mcp.implementation.job_cancellation.check_slurm_available", + return_value=False, ): - from implementation.job_cancellation import cancel_slurm_job + from slurm_mcp.implementation.job_cancellation import cancel_slurm_job try: cancel_slurm_job("12345") @@ -502,8 +516,10 @@ def test_direct_slurm_unavailable_paths(): assert "Slurm is not available" in str(e) # Test job_listing RuntimeError path - with patch("implementation.job_listing.check_slurm_available", return_value=False): - from implementation.job_listing import list_slurm_jobs + with patch( + "slurm_mcp.implementation.job_listing.check_slurm_available", return_value=False + ): + from slurm_mcp.implementation.job_listing import list_slurm_jobs try: list_slurm_jobs() @@ -514,12 +530,15 @@ def test_direct_slurm_unavailable_paths(): def test_job_submission_error_paths(): """Test job submission error handling paths.""" - from implementation.job_submission import submit_slurm_job + from slurm_mcp.implementation.job_submission import submit_slurm_job # Test when cores <= 0 (with file existence mocked) with ( patch("os.path.isfile", return_value=True), - patch("implementation.job_submission.check_slurm_available", return_value=True), + patch( + "slurm_mcp.implementation.job_submission.check_slurm_available", + return_value=True, + ), ): try: submit_slurm_job("/test/script.sh", 0) @@ -530,7 +549,10 @@ def test_job_submission_error_paths(): # Test when cores > max allowed - need to mock the entire file operation chain with ( patch("os.path.isfile", return_value=True), - patch("implementation.job_submission.check_slurm_available", return_value=True), + patch( + "slurm_mcp.implementation.job_submission.check_slurm_available", + return_value=True, + ), patch("builtins.open", mock_open(read_data="#!/bin/bash\necho 'test'")), patch("tempfile.mkstemp", return_value=(1, "/tmp/test.sh")), patch("os.close"), @@ -547,10 +569,12 @@ def test_job_submission_error_paths(): def test_array_jobs_missing_lines(): """Test array jobs missing coverage lines.""" - from implementation.array_jobs import submit_array_job + from slurm_mcp.implementation.array_jobs import submit_array_job # Test the missing lines by triggering specific error conditions - with patch("implementation.array_jobs.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.array_jobs.check_slurm_available", return_value=False + ): try: submit_array_job("/test/script.sh", "1-10", 2) assert False, "Should have raised RuntimeError" @@ -560,12 +584,15 @@ def test_array_jobs_missing_lines(): def test_job_submission_specific_error_lines(): """Test specific lines in job submission.""" - from implementation.job_submission import submit_slurm_job + from slurm_mcp.implementation.job_submission import submit_slurm_job # Test subprocess failure that triggers line 94 with ( patch("os.path.isfile", return_value=True), - patch("implementation.job_submission.check_slurm_available", return_value=True), + patch( + "slurm_mcp.implementation.job_submission.check_slurm_available", + return_value=True, + ), patch("builtins.open", mock_open(read_data="#!/bin/bash\necho 'test'")), patch("tempfile.mkstemp", return_value=(1, "/tmp/test.sh")), patch("os.close"), @@ -584,7 +611,10 @@ def test_job_submission_specific_error_lines(): # Test output parsing failure that triggers line 101 with ( patch("os.path.isfile", return_value=True), - patch("implementation.job_submission.check_slurm_available", return_value=True), + patch( + "slurm_mcp.implementation.job_submission.check_slurm_available", + return_value=True, + ), patch("builtins.open", mock_open(read_data="#!/bin/bash\necho 'test'")), patch("tempfile.mkstemp", return_value=(1, "/tmp/test.sh")), patch("os.fdopen", mock_open()), @@ -604,7 +634,7 @@ def test_job_submission_specific_error_lines(): def test_job_listing_specific_line(): """Test specific line in job listing.""" - from implementation.job_listing import list_slurm_jobs + from slurm_mcp.implementation.job_listing import list_slurm_jobs # Test with malformed output that triggers line 44 (parts length check) with patch("subprocess.run") as mock_run: @@ -619,10 +649,12 @@ def test_job_listing_specific_line(): def test_job_details_comprehensive(): """Test job details with comprehensive error scenarios.""" - from implementation.job_details import get_job_details + from slurm_mcp.implementation.job_details import get_job_details # Test Slurm unavailable error (line 21) - with patch("implementation.job_details.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.job_details.check_slurm_available", return_value=False + ): try: get_job_details("12345") assert False, "Should have raised RuntimeError" @@ -668,10 +700,12 @@ def test_job_details_comprehensive(): def test_job_output_comprehensive(): """Test job output with various scenarios.""" - from implementation.job_output import get_job_output + from slurm_mcp.implementation.job_output import get_job_output # Test Slurm unavailable error (line 23) - with patch("implementation.job_output.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.job_output.check_slurm_available", return_value=False + ): try: get_job_output("12345") assert False, "Should have raised RuntimeError" @@ -680,7 +714,7 @@ def test_job_output_comprehensive(): # Test successful file reading by mocking job_details and file operations with ( - patch("implementation.job_output.get_job_details") as mock_details, + patch("slurm_mcp.implementation.job_output.get_job_details") as mock_details, patch("os.path.exists") as mock_exists, patch("builtins.open", mock_open(read_data="Job output content")), ): @@ -694,7 +728,7 @@ def test_job_output_comprehensive(): # Test file read permission error with ( - patch("implementation.job_output.get_job_details") as mock_details, + patch("slurm_mcp.implementation.job_output.get_job_details") as mock_details, patch("os.path.exists", return_value=True), patch("builtins.open", side_effect=PermissionError("Permission denied")), ): @@ -706,10 +740,12 @@ def test_job_output_comprehensive(): def test_queue_info_comprehensive(): """Test queue info with comprehensive scenarios.""" - from implementation.queue_info import get_queue_info + from slurm_mcp.implementation.queue_info import get_queue_info # Test Slurm unavailable error (line 22) - with patch("implementation.queue_info.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.queue_info.check_slurm_available", return_value=False + ): try: get_queue_info() assert False, "Should have raised RuntimeError" @@ -744,10 +780,12 @@ def test_queue_info_comprehensive(): def test_node_info_comprehensive(): """Test node info with comprehensive scenarios.""" - from implementation.node_info import get_node_info + from slurm_mcp.implementation.node_info import get_node_info # Test Slurm unavailable error (line 18) - with patch("implementation.node_info.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.node_info.check_slurm_available", return_value=False + ): try: get_node_info() assert False, "Should have raised RuntimeError" @@ -772,10 +810,13 @@ def test_node_info_comprehensive(): def test_cluster_info_comprehensive(): """Test cluster info with comprehensive scenarios.""" - from implementation.cluster_info import get_slurm_info + from slurm_mcp.implementation.cluster_info import get_slurm_info # Test Slurm unavailable error (line 18) - with patch("implementation.cluster_info.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.cluster_info.check_slurm_available", + return_value=False, + ): try: get_slurm_info() assert False, "Should have raised RuntimeError" @@ -799,7 +840,7 @@ def test_cluster_info_comprehensive(): def test_slurm_handler_comprehensive(): """Test slurm_handler module comprehensively.""" - import implementation.slurm_handler as slurm_handler + import slurm_mcp.implementation.slurm_handler as slurm_handler # Test that all functions are available assert hasattr(slurm_handler, "submit_slurm_job") @@ -823,10 +864,12 @@ def test_slurm_handler_comprehensive(): def test_array_jobs_comprehensive(): """Test array_jobs module comprehensively.""" - from implementation.array_jobs import submit_array_job + from slurm_mcp.implementation.array_jobs import submit_array_job # Test Slurm unavailable error - with patch("implementation.array_jobs.check_slurm_available", return_value=False): + with patch( + "slurm_mcp.implementation.array_jobs.check_slurm_available", return_value=False + ): try: submit_array_job("/test/script.sh", "1-10", 2) assert False, "Should have raised RuntimeError" @@ -865,7 +908,7 @@ def test_array_jobs_comprehensive(): def test_node_allocation_comprehensive(): """Test node_allocation module comprehensively.""" - from implementation.node_allocation import ( + from slurm_mcp.implementation.node_allocation import ( allocate_nodes, deallocate_nodes, get_allocation_status, @@ -873,7 +916,8 @@ def test_node_allocation_comprehensive(): # Test allocate_nodes with Slurm unavailable with patch( - "implementation.node_allocation.check_slurm_available", return_value=False + "slurm_mcp.implementation.node_allocation.check_slurm_available", + return_value=False, ): result = allocate_nodes(nodes=2, time_limit="1:00:00") assert result["status"] == "failed" @@ -921,7 +965,7 @@ def test_additional_coverage_improvements(): """Additional tests to improve coverage on remaining low-coverage modules.""" # Test job_details sacct fallback path (lines 55-78) - from implementation.job_details import get_job_details + from slurm_mcp.implementation.job_details import get_job_details with patch("subprocess.run") as mock_run: # First scontrol call fails, then sacct succeeds @@ -943,10 +987,10 @@ def run_side_effect(*args, **kwargs): assert result["source"] == "accounting" # Test job_output stderr path and multiple file locations (lines 47-57) - from implementation.job_output import get_job_output + from slurm_mcp.implementation.job_output import get_job_output with ( - patch("implementation.job_output.get_job_details") as mock_details, + patch("slurm_mcp.implementation.job_output.get_job_details") as mock_details, patch("os.path.exists") as mock_exists, ): # Test stderr output type @@ -963,7 +1007,7 @@ def exists_side_effect(path): assert result["content"] == "Error content" # Test job_listing with insufficient parts (line 44) - from implementation.job_listing import list_slurm_jobs + from slurm_mcp.implementation.job_listing import list_slurm_jobs with patch("subprocess.run") as mock_run: mock_run.return_value.returncode = 0 @@ -975,7 +1019,10 @@ def exists_side_effect(path): def test_node_allocation_additional_coverage(): """Test additional node allocation paths to improve coverage.""" - from implementation.node_allocation import allocate_nodes, get_allocation_status + from slurm_mcp.implementation.node_allocation import ( + allocate_nodes, + get_allocation_status, + ) # Test allocation with various parameters to hit more code paths with patch("subprocess.run") as mock_run: @@ -1008,7 +1055,10 @@ def test_node_allocation_additional_coverage(): def test_node_allocation_missing_lines(): """Test specific missing lines in node_allocation.py to improve coverage.""" - from implementation.node_allocation import allocate_nodes, deallocate_nodes + from slurm_mcp.implementation.node_allocation import ( + allocate_nodes, + deallocate_nodes, + ) # Test immediate allocation path (lines 83-84) with patch("subprocess.run") as mock_run: @@ -1047,7 +1097,7 @@ def test_node_allocation_missing_lines(): def test_node_allocation_comprehensive_error_paths(): """Test comprehensive error paths in node_allocation.py.""" - from implementation.node_allocation import get_allocation_status + from slurm_mcp.implementation.node_allocation import get_allocation_status # Test get_allocation_status with no job info (lines 300-303) with patch("subprocess.run") as mock_run: @@ -1067,7 +1117,7 @@ def test_node_allocation_comprehensive_error_paths(): def test_server_missing_coverage(): """Test server.py missing coverage lines.""" - import server + import slurm_mcp.server as server # Test SlurmMCPError creation (lines 21-23) error = server.SlurmMCPError("Test error message") @@ -1075,13 +1125,13 @@ def test_server_missing_coverage(): assert isinstance(error, Exception) # Test logger configuration (lines 29-30) - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" assert hasattr(server.logger, "info") # Test main function argument parsing (lines 913-920) with ( - patch("sys.argv", ["slurm-mcp", "--transport", "sse", "--port", "9000"]), - patch("server.mcp.run"), + patch("sys.argv", ["slurm-mcp", "--transport", "http", "--port", "9000"]), + patch.object(server.mcp, "run"), ): try: server.main() @@ -1093,7 +1143,7 @@ def test_server_missing_coverage(): def test_mcp_handlers_missing_coverage(): """Test mcp_handlers.py missing coverage lines.""" - import mcp_handlers + import slurm_mcp.mcp_handlers as mcp_handlers # Test that the module loads properly - the missing lines are likely # error handling paths that are hard to trigger directly @@ -1106,7 +1156,7 @@ def test_mcp_handlers_missing_coverage(): def test_cluster_info_missing_lines(): """Test cluster_info.py missing lines 57-58.""" - from implementation.cluster_info import get_slurm_info + from slurm_mcp.implementation.cluster_info import get_slurm_info # Test subprocess exception handling (lines 57-58) with patch("subprocess.run", side_effect=Exception("Command execution failed")): @@ -1117,7 +1167,7 @@ def test_cluster_info_missing_lines(): def test_array_jobs_missing_lines_comprehensive(): """Test array_jobs.py missing lines 66, 96.""" - from implementation.array_jobs import submit_array_job + from slurm_mcp.implementation.array_jobs import submit_array_job # Test file reading exception (line 66) with patch("builtins.open", side_effect=Exception("File read error")): @@ -1137,11 +1187,11 @@ def test_array_jobs_missing_lines_comprehensive(): def test_job_output_missing_line(): """Test job_output.py missing line 78.""" - from implementation.job_output import get_job_output + from slurm_mcp.implementation.job_output import get_job_output # Test exception handling in file reading (line 78) with ( - patch("implementation.job_output.get_job_details") as mock_details, + patch("slurm_mcp.implementation.job_output.get_job_details") as mock_details, patch("os.path.exists", return_value=True), patch("builtins.open", side_effect=Exception("File operation failed")), ): @@ -1158,16 +1208,19 @@ def test_job_output_missing_line(): def test_node_allocation_enhanced_coverage(): """Enhanced tests for node_allocation.py missing lines to improve coverage.""" - from implementation.node_allocation import allocate_nodes + from slurm_mcp.implementation.node_allocation import allocate_nodes # Test allocation with no immediate mode (line 132) with patch( - "implementation.node_allocation.check_slurm_available", return_value=True + "slurm_mcp.implementation.node_allocation.check_slurm_available", + return_value=True, ): - with patch("implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") with patch( - "implementation.node_allocation._get_recent_allocation_id", + "slurm_mcp.implementation.node_allocation._get_recent_allocation_id", return_value="12345", ): result = allocate_nodes(nodes=1, cores=2, immediate=False) @@ -1180,15 +1233,16 @@ def test_node_allocation_enhanced_coverage(): def test_node_allocation_timeout_handling(): """Test allocation timeout and subprocess error handling (lines 184-187).""" - from implementation.node_allocation import allocate_nodes + from slurm_mcp.implementation.node_allocation import allocate_nodes import subprocess with patch( - "implementation.node_allocation.check_slurm_available", return_value=True + "slurm_mcp.implementation.node_allocation.check_slurm_available", + return_value=True, ): # Test timeout exception with patch( - "implementation.node_allocation.subprocess.run", + "slurm_mcp.implementation.node_allocation.subprocess.run", side_effect=subprocess.TimeoutExpired("salloc", 60), ): result = allocate_nodes(nodes=1, cores=2) @@ -1197,7 +1251,7 @@ def test_node_allocation_timeout_handling(): # Test other subprocess exceptions with patch( - "implementation.node_allocation.subprocess.run", + "slurm_mcp.implementation.node_allocation.subprocess.run", side_effect=subprocess.CalledProcessError(1, "salloc"), ): result = allocate_nodes(nodes=1, cores=2) @@ -1206,10 +1260,13 @@ def test_node_allocation_timeout_handling(): def test_node_allocation_recent_allocation_parsing(): """Test _get_recent_allocation_id with various output formats (lines 228-239).""" - from implementation.node_allocation import _get_recent_allocation_id + from slurm_mcp.implementation.node_allocation import _get_recent_allocation_id - with patch("implementation.node_allocation.subprocess.run") as mock_run: - with patch("implementation.node_allocation.os.getenv", return_value="testuser"): + with patch("slurm_mcp.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.os.getenv", + return_value="testuser", + ): # Test successful parsing mock_run.return_value = Mock( returncode=0, @@ -1244,7 +1301,7 @@ def test_node_allocation_recent_allocation_parsing(): def test_node_allocation_salloc_output_parsing(): """Test _parse_salloc_output with different formats (lines 265-266, 271-274).""" - from implementation.node_allocation import _parse_salloc_output + from slurm_mcp.implementation.node_allocation import _parse_salloc_output # Test various salloc output formats test_outputs = [ @@ -1263,9 +1320,9 @@ def test_node_allocation_salloc_output_parsing(): def test_node_allocation_get_allocation_nodes(): """Test _get_allocation_nodes with various scenarios (lines 300-301).""" - from implementation.node_allocation import _get_allocation_nodes + from slurm_mcp.implementation.node_allocation import _get_allocation_nodes - with patch("implementation.node_allocation.subprocess.run") as mock_run: + with patch("slurm_mcp.implementation.node_allocation.subprocess.run") as mock_run: # Test successful node query mock_run.return_value = Mock(returncode=0, stdout="node01,node02", stderr="") result = _get_allocation_nodes("12345") @@ -1284,14 +1341,15 @@ def test_node_allocation_get_allocation_nodes(): def test_node_allocation_deallocate_error_handling(): """Test deallocate error handling (line 369).""" - from implementation.node_allocation import deallocate_nodes + from slurm_mcp.implementation.node_allocation import deallocate_nodes with patch( - "implementation.node_allocation.check_slurm_available", return_value=True + "slurm_mcp.implementation.node_allocation.check_slurm_available", + return_value=True, ): # Test subprocess error in deallocation with patch( - "implementation.node_allocation.subprocess.run", + "slurm_mcp.implementation.node_allocation.subprocess.run", side_effect=Exception("Deallocation failed"), ): result = deallocate_nodes("12345") @@ -1301,14 +1359,15 @@ def test_node_allocation_deallocate_error_handling(): def test_node_allocation_status_error_handling(): """Test allocation status error handling (line 426).""" - from implementation.node_allocation import get_allocation_status + from slurm_mcp.implementation.node_allocation import get_allocation_status with patch( - "implementation.node_allocation.check_slurm_available", return_value=True + "slurm_mcp.implementation.node_allocation.check_slurm_available", + return_value=True, ): # Test subprocess error in status check with patch( - "implementation.node_allocation.subprocess.run", + "slurm_mcp.implementation.node_allocation.subprocess.run", side_effect=Exception("Status check failed"), ): result = get_allocation_status("12345") @@ -1318,7 +1377,7 @@ def test_node_allocation_status_error_handling(): def test_node_allocation_expand_node_list_edge_cases(): """Test _expand_node_list with complex scenarios (lines 436-438).""" - from implementation.node_allocation import _expand_node_list + from slurm_mcp.implementation.node_allocation import _expand_node_list # Test various node list formats test_cases = [ @@ -1339,11 +1398,11 @@ def test_node_allocation_expand_node_list_edge_cases(): def test_node_allocation_edge_cases(): """Test various edge cases in node allocation (lines 454-455, 490-491).""" - from implementation.node_allocation import _get_recent_allocation_id + from slurm_mcp.implementation.node_allocation import _get_recent_allocation_id # Test with missing environment variable - with patch("implementation.node_allocation.os.getenv", return_value=None): - with patch("implementation.node_allocation.subprocess.run"): + with patch("slurm_mcp.implementation.node_allocation.os.getenv", return_value=None): + with patch("slurm_mcp.implementation.node_allocation.subprocess.run"): result = _get_recent_allocation_id() # Should handle None user gracefully assert result is None or isinstance(result, str) @@ -1352,7 +1411,7 @@ def test_node_allocation_edge_cases(): import subprocess with patch( - "implementation.node_allocation.subprocess.run", + "slurm_mcp.implementation.node_allocation.subprocess.run", side_effect=subprocess.TimeoutExpired("squeue", 5), ): result = _get_recent_allocation_id() @@ -1366,7 +1425,7 @@ def test_node_allocation_edge_cases(): def test_server_enhanced_coverage(): """Enhanced tests for server.py missing lines to improve coverage.""" - import server + import slurm_mcp.server as server # Test argument parsing with custom host (line 881) with patch( @@ -1374,40 +1433,39 @@ def test_server_enhanced_coverage(): [ "slurm-mcp", "--transport", - "sse", + "http", "--host", "custom.host.com", "--port", "9001", ], ): - with patch("server.mcp.run") as mock_run: + with patch.object(server.mcp, "run") as mock_run: with patch("builtins.print"): try: server.main() except SystemExit: pass mock_run.assert_called_with( - transport="sse", host="custom.host.com", port=9001 + transport="http", host="custom.host.com", port=9001 ) def test_server_error_exception_handling(): - """Test server exception handling in main (line 937).""" - import server - - # Test main function with server run exception - with patch("sys.argv", ["slurm-mcp"]): - with patch("server.mcp.run", side_effect=KeyboardInterrupt("User interrupted")): - with patch("builtins.print") as mock_print: - with patch("sys.exit") as mock_exit: - try: - server.main() - except (SystemExit, KeyboardInterrupt): - pass + """Test server exception handling in main - exceptions propagate from main().""" + import pytest + import slurm_mcp.server as server - # Verify error handling was triggered - assert mock_print.called or mock_exit.called + # Test main function with server run exception - KeyboardInterrupt propagates + with ( + patch("sys.argv", ["slurm-mcp"]), + patch( + "slurm_mcp.server.mcp.run", + side_effect=KeyboardInterrupt("User interrupted"), + ), + ): + with pytest.raises(KeyboardInterrupt): + server.main() def test_server_dotenv_import_failure(): @@ -1415,11 +1473,11 @@ def test_server_dotenv_import_failure(): # Test the case where dotenv is not available with patch.dict("sys.modules", {"dotenv": None}): # Delete server from modules to force re-import - if "server" in sys.modules: - del sys.modules["server"] + if "slurm_mcp.server" in sys.modules: + del sys.modules["slurm_mcp.server"] # This should trigger the dotenv ImportError handling - import server + import slurm_mcp.server as server # Server should still work without dotenv assert hasattr(server, "mcp") @@ -1428,7 +1486,7 @@ def test_server_dotenv_import_failure(): def test_server_comprehensive_tool_coverage(): """Test comprehensive tool coverage for server.py.""" - import server + import slurm_mcp.server as server # Test that all async tool functions are properly wrapped async_tools = [ @@ -1459,7 +1517,7 @@ def test_server_fastmcp_import_failure(): """Test server behavior when FastMCP import fails.""" # This is harder to test since the server exits on import failure # But we can verify the import error handling exists - import server + import slurm_mcp.server as server # Just verify that FastMCP was imported successfully in our case assert hasattr(server, "FastMCP") diff --git a/clio-kit-mcp-servers/slurm/tests/test_init.py b/clio-kit-mcp-servers/slurm/tests/test_init.py index e13c62a1..0642e8e9 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_init.py +++ b/clio-kit-mcp-servers/slurm/tests/test_init.py @@ -2,28 +2,19 @@ Tests for the main package __init__.py file. """ -import sys -from pathlib import Path - -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) +import slurm_mcp def test_package_metadata(): """Test that package metadata is accessible.""" - import src - - assert hasattr(src, "__version__") - assert hasattr(src, "__author__") - assert src.__version__ == "1.0.0" - assert src.__author__ == "IoWarp Scientific MCPs" + assert hasattr(slurm_mcp, "__version__") + assert hasattr(slurm_mcp, "__author__") + assert slurm_mcp.__version__ == "1.0.0" + assert slurm_mcp.__author__ == "IoWarp Scientific MCPs" def test_package_docstring(): """Test that package has a docstring.""" - import src - - assert src.__doc__ is not None - assert "Slurm MCP Server" in src.__doc__ - assert "Model Context Protocol" in src.__doc__ + assert slurm_mcp.__doc__ is not None + assert "Slurm MCP Server" in slurm_mcp.__doc__ + assert "Model Context Protocol" in slurm_mcp.__doc__ diff --git a/clio-kit-mcp-servers/slurm/tests/test_integration.py b/clio-kit-mcp-servers/slurm/tests/test_integration.py index d4e33c26..a57a3ce0 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_integration.py +++ b/clio-kit-mcp-servers/slurm/tests/test_integration.py @@ -6,25 +6,20 @@ import pytest import tempfile import os -import sys import time -# Add src to path -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) - -# Import implementation modules directly -from implementation.job_submission import submit_slurm_job -from implementation.job_status import get_job_status -from implementation.job_cancellation import cancel_slurm_job -from implementation.job_listing import list_slurm_jobs -from implementation.cluster_info import get_slurm_info -from implementation.job_details import get_job_details -from implementation.job_output import get_job_output -from implementation.queue_info import get_queue_info -from implementation.array_jobs import submit_array_job -from implementation.node_info import get_node_info - -from implementation.slurm_handler import _check_slurm_available +from slurm_mcp.implementation.job_submission import submit_slurm_job +from slurm_mcp.implementation.job_status import get_job_status +from slurm_mcp.implementation.job_cancellation import cancel_slurm_job +from slurm_mcp.implementation.job_listing import list_slurm_jobs +from slurm_mcp.implementation.cluster_info import get_slurm_info +from slurm_mcp.implementation.job_details import get_job_details +from slurm_mcp.implementation.job_output import get_job_output +from slurm_mcp.implementation.queue_info import get_queue_info +from slurm_mcp.implementation.array_jobs import submit_array_job +from slurm_mcp.implementation.node_info import get_node_info + +from slurm_mcp.implementation.slurm_handler import _check_slurm_available class TestIntegration: diff --git a/clio-kit-mcp-servers/slurm/tests/test_mcp_handlers.py b/clio-kit-mcp-servers/slurm/tests/test_mcp_handlers.py index 66704fdd..04793e88 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_mcp_handlers.py +++ b/clio-kit-mcp-servers/slurm/tests/test_mcp_handlers.py @@ -3,10 +3,8 @@ Tests the MCP protocol layer that wraps Slurm capabilities. """ -import sys -from pathlib import Path from unittest.mock import patch -from mcp_handlers import ( +from slurm_mcp.mcp_handlers import ( submit_slurm_job_handler, check_job_status_handler, cancel_slurm_job_handler, @@ -19,10 +17,6 @@ get_node_info_handler, ) -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) - class TestMCPHandlers: """Test class for MCP handlers.""" @@ -59,7 +53,9 @@ def test_submit_job_handler_with_exception(self, valid_cores): def test_check_status_handler_with_exception(self): """Test check status handler with exception.""" # Create a scenario that might cause an exception by mocking - with patch("mcp_handlers.get_job_status", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_job_status", side_effect=Exception("Test error") + ): result = check_job_status_handler("12345") assert isinstance(result, dict) @@ -72,7 +68,8 @@ def test_check_status_handler_with_exception(self): def test_cancel_job_handler_with_exception(self): """Test cancel job handler with exception.""" with patch( - "mcp_handlers.cancel_slurm_job", side_effect=Exception("Test error") + "slurm_mcp.mcp_handlers.cancel_slurm_job", + side_effect=Exception("Test error"), ): result = cancel_slurm_job_handler("12345") @@ -82,7 +79,10 @@ def test_cancel_job_handler_with_exception(self): def test_list_jobs_handler_with_exception(self): """Test list jobs handler with exception.""" - with patch("mcp_handlers.list_slurm_jobs", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.list_slurm_jobs", + side_effect=Exception("Test error"), + ): result = list_slurm_jobs_handler() assert isinstance(result, dict) @@ -91,7 +91,9 @@ def test_list_jobs_handler_with_exception(self): def test_get_slurm_info_handler_with_exception(self): """Test get Slurm info handler with exception.""" - with patch("mcp_handlers.get_slurm_info", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_slurm_info", side_effect=Exception("Test error") + ): result = get_slurm_info_handler() assert isinstance(result, dict) @@ -100,7 +102,10 @@ def test_get_slurm_info_handler_with_exception(self): def test_get_job_details_handler_with_exception(self): """Test get job details handler with exception.""" - with patch("mcp_handlers.get_job_details", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_job_details", + side_effect=Exception("Test error"), + ): result = get_job_details_handler("12345") assert isinstance(result, dict) @@ -109,7 +114,9 @@ def test_get_job_details_handler_with_exception(self): def test_get_job_output_handler_with_exception(self): """Test get job output handler with exception.""" - with patch("mcp_handlers.get_job_output", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_job_output", side_effect=Exception("Test error") + ): result = get_job_output_handler("12345") assert isinstance(result, dict) @@ -118,7 +125,9 @@ def test_get_job_output_handler_with_exception(self): def test_get_queue_info_handler_with_exception(self): """Test get queue info handler with exception.""" - with patch("mcp_handlers.get_queue_info", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_queue_info", side_effect=Exception("Test error") + ): result = get_queue_info_handler() assert isinstance(result, dict) @@ -128,7 +137,8 @@ def test_get_queue_info_handler_with_exception(self): def test_submit_array_job_handler_with_exception(self, valid_cores): """Test submit array job handler with exception.""" with patch( - "mcp_handlers.submit_array_job", side_effect=Exception("Test error") + "slurm_mcp.mcp_handlers.submit_array_job", + side_effect=Exception("Test error"), ): result = submit_array_job_handler( "/non/existent/script.sh", "1-5", valid_cores @@ -140,7 +150,9 @@ def test_submit_array_job_handler_with_exception(self, valid_cores): def test_get_node_info_handler_with_exception(self): """Test get node info handler with exception.""" - with patch("mcp_handlers.get_node_info", side_effect=Exception("Test error")): + with patch( + "slurm_mcp.mcp_handlers.get_node_info", side_effect=Exception("Test error") + ): result = get_node_info_handler() assert isinstance(result, dict) @@ -536,7 +548,7 @@ def test_check_job_status_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"job_id": "12345", "status": "RUNNING"} - with patch("mcp_handlers.get_job_status", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_job_status", return_value=mock_result): result = check_job_status_handler("12345") assert "real_slurm" in result @@ -550,7 +562,7 @@ def test_cancel_slurm_job_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"job_id": "12345", "status": "cancelled"} - with patch("mcp_handlers.cancel_slurm_job", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.cancel_slurm_job", return_value=mock_result): result = cancel_slurm_job_handler("12345") assert "real_slurm" in result @@ -564,7 +576,7 @@ def test_list_slurm_jobs_handler_with_filters(self): # Mock the underlying function mock_result = {"jobs": [], "total": 0} - with patch("mcp_handlers.list_slurm_jobs", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.list_slurm_jobs", return_value=mock_result): result = list_slurm_jobs_handler( user="testuser", state="RUNNING", partition="compute" ) @@ -585,7 +597,7 @@ def test_get_slurm_info_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"cluster_name": "test-cluster", "version": "20.11.8"} - with patch("mcp_handlers.get_slurm_info", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_slurm_info", return_value=mock_result): result = get_slurm_info_handler() assert "real_slurm" in result @@ -598,7 +610,7 @@ def test_get_job_details_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"job_id": "12345", "name": "test_job", "state": "COMPLETED"} - with patch("mcp_handlers.get_job_details", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_job_details", return_value=mock_result): result = get_job_details_handler("12345") assert "real_slurm" in result @@ -612,7 +624,7 @@ def test_get_job_output_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"job_id": "12345", "stdout": "Hello World", "stderr": ""} - with patch("mcp_handlers.get_job_output", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_job_output", return_value=mock_result): result = get_job_output_handler("12345") assert "real_slurm" in result @@ -626,7 +638,7 @@ def test_get_queue_info_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"partitions": [{"name": "compute", "state": "up"}]} - with patch("mcp_handlers.get_queue_info", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_queue_info", return_value=mock_result): result = get_queue_info_handler() assert "real_slurm" in result @@ -639,7 +651,7 @@ def test_submit_array_job_handler_real_slurm_field(self): # Mock the underlying function to return result without real_slurm mock_result = {"job_id": "12345_[1-10]", "status": "submitted"} - with patch("mcp_handlers.submit_array_job", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.submit_array_job", return_value=mock_result): result = submit_array_job_handler("/test/script.sh", "1-10") assert "real_slurm" in result @@ -652,7 +664,7 @@ def test_get_node_info_handler_partition_field(self): # Mock the underlying function mock_result = {"nodes": [{"name": "node001", "state": "idle"}]} - with patch("mcp_handlers.get_node_info", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_node_info", return_value=mock_result): # get_node_info_handler doesn't take partition parameter, test basic functionality result = get_node_info_handler() @@ -661,7 +673,7 @@ def test_get_node_info_handler_partition_field(self): def test_error_response_creation(self): """Test _create_error_response function.""" - from mcp_handlers import _create_error_response + from slurm_mcp.mcp_handlers import _create_error_response result = _create_error_response("Test error message", "test_function") @@ -678,12 +690,14 @@ def test_handlers_with_non_dict_results(self): from unittest.mock import patch # Test with string result - with patch("mcp_handlers.get_job_status", return_value="Invalid response"): + with patch( + "slurm_mcp.mcp_handlers.get_job_status", return_value="Invalid response" + ): result = check_job_status_handler("12345") assert result == "Invalid response" # Test with None result - with patch("mcp_handlers.get_job_status", return_value=None): + with patch("slurm_mcp.mcp_handlers.get_job_status", return_value=None): result = check_job_status_handler("12345") assert result is None @@ -694,13 +708,13 @@ def test_list_jobs_handler_partial_filters(self): mock_result = {"jobs": [], "total": 0} # Test with only user filter - with patch("mcp_handlers.list_slurm_jobs", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.list_slurm_jobs", return_value=mock_result): result = list_slurm_jobs_handler(user="testuser") assert "user_filter" in result # Note: When real_slurm is False, empty filters may still be present # Test with only state filter - with patch("mcp_handlers.list_slurm_jobs", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.list_slurm_jobs", return_value=mock_result): result = list_slurm_jobs_handler(state="RUNNING") assert "state_filter" in result # Note: When real_slurm is False, empty filters may still be present @@ -711,7 +725,7 @@ def test_node_info_handler_without_partition(self): mock_result = {"nodes": []} - with patch("mcp_handlers.get_node_info", return_value=mock_result): + with patch("slurm_mcp.mcp_handlers.get_node_info", return_value=mock_result): result = get_node_info_handler() assert "partition_filter" not in result diff --git a/clio-kit-mcp-servers/slurm/tests/test_node_allocation_coverage.py b/clio-kit-mcp-servers/slurm/tests/test_node_allocation_coverage.py index 4266c8b9..2951159a 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_node_allocation_coverage.py +++ b/clio-kit-mcp-servers/slurm/tests/test_node_allocation_coverage.py @@ -4,7 +4,7 @@ """ from unittest.mock import Mock, patch -from src.implementation.node_allocation import ( +from slurm_mcp.implementation.node_allocation import ( allocate_nodes, deallocate_nodes, get_allocation_status, @@ -21,10 +21,12 @@ class TestNodeAllocationCoverage: def test_allocate_nodes_with_memory_specification(self): """Test allocate_nodes with memory specification.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=0, stdout="Granted job allocation 12345\n", stderr="" ) @@ -43,7 +45,7 @@ def test_allocate_nodes_with_memory_specification(self): def test_allocate_nodes_without_slurm(self): """Test allocate_nodes when Slurm is not available.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=False, ): result = allocate_nodes(nodes=1, cores=1) @@ -53,17 +55,19 @@ def test_allocate_nodes_without_slurm(self): def test_allocate_nodes_immediate_mode(self): """Test immediate allocation mode.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") with patch( - "src.implementation.node_allocation._get_recent_allocation_id", + "slurm_mcp.implementation.node_allocation._get_recent_allocation_id", return_value="12345", ): with patch( - "src.implementation.node_allocation._get_allocation_nodes", + "slurm_mcp.implementation.node_allocation._get_allocation_nodes", return_value={"nodes": ["node01"]}, ): result = allocate_nodes(nodes=1, cores=2, immediate=True) @@ -75,10 +79,12 @@ def test_allocate_nodes_timeout_error(self): import subprocess with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.side_effect = subprocess.TimeoutExpired("salloc", 60) result = allocate_nodes(nodes=1, cores=1) @@ -87,10 +93,12 @@ def test_allocate_nodes_timeout_error(self): def test_allocate_nodes_policy_violation(self): """Test allocation policy violation error.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=1, stdout="", stderr="Job violates accounting/QOS policy" ) @@ -102,10 +110,12 @@ def test_allocate_nodes_policy_violation(self): def test_allocate_nodes_insufficient_resources(self): """Test insufficient resources error.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=1, stdout="", stderr="Unable to allocate resources" ) @@ -160,7 +170,9 @@ def test_parse_salloc_output_various_formats(self): def test_get_allocation_nodes_with_valid_id(self): """Test _get_allocation_nodes with valid allocation ID.""" - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=0, stdout="node01,node02 RUNNING 8 16000", stderr="" ) @@ -170,7 +182,9 @@ def test_get_allocation_nodes_with_valid_id(self): def test_get_allocation_nodes_with_invalid_id(self): """Test _get_allocation_nodes with invalid allocation ID.""" - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=1, stdout="", stderr="Invalid job id specified" ) @@ -180,9 +194,12 @@ def test_get_allocation_nodes_with_invalid_id(self): def test_get_recent_allocation_id_found(self): """Test _get_recent_allocation_id when allocation exists.""" - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: with patch( - "src.implementation.node_allocation.os.getenv", return_value="testuser" + "slurm_mcp.implementation.node_allocation.os.getenv", + return_value="testuser", ): mock_run.return_value = Mock( returncode=0, @@ -195,7 +212,9 @@ def test_get_recent_allocation_id_found(self): def test_get_recent_allocation_id_not_found(self): """Test _get_recent_allocation_id when no allocation exists.""" - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") result = _get_recent_allocation_id() @@ -204,10 +223,12 @@ def test_get_recent_allocation_id_not_found(self): def test_deallocate_nodes_success(self): """Test deallocate_nodes with successful deallocation.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") result = deallocate_nodes("12345") @@ -217,7 +238,7 @@ def test_deallocate_nodes_success(self): def test_deallocate_nodes_without_slurm(self): """Test deallocate_nodes when Slurm is not available.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=False, ): result = deallocate_nodes("12345") @@ -227,10 +248,12 @@ def test_deallocate_nodes_without_slurm(self): def test_deallocate_nodes_failure(self): """Test deallocate_nodes with failed deallocation.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=1, stdout="", stderr="scancel: Invalid job id 99999" ) @@ -241,10 +264,12 @@ def test_deallocate_nodes_failure(self): def test_get_allocation_status_success(self): """Test get_allocation_status with valid allocation.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=0, stdout="12345 RUNNING node[01-02] user 2 8", stderr="" ) @@ -256,7 +281,7 @@ def test_get_allocation_status_success(self): def test_get_allocation_status_without_slurm(self): """Test get_allocation_status when Slurm is not available.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=False, ): result = get_allocation_status("12345") @@ -266,10 +291,12 @@ def test_get_allocation_status_without_slurm(self): def test_get_allocation_status_not_found(self): """Test get_allocation_status with non-existent allocation.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock( returncode=1, stdout="", stderr="Invalid job id specified" ) @@ -282,13 +309,15 @@ def test_get_allocation_status_not_found(self): def test_allocate_nodes_with_job_name(self): """Test allocate_nodes with custom job name.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") with patch( - "src.implementation.node_allocation._get_recent_allocation_id", + "slurm_mcp.implementation.node_allocation._get_recent_allocation_id", return_value="12345", ): allocate_nodes(nodes=1, cores=1, job_name="test_job") @@ -300,13 +329,15 @@ def test_allocate_nodes_with_job_name(self): def test_allocate_nodes_default_job_name(self): """Test allocate_nodes with default job name.""" with patch( - "src.implementation.node_allocation.check_slurm_available", + "slurm_mcp.implementation.node_allocation.check_slurm_available", return_value=True, ): - with patch("src.implementation.node_allocation.subprocess.run") as mock_run: + with patch( + "slurm_mcp.implementation.node_allocation.subprocess.run" + ) as mock_run: mock_run.return_value = Mock(returncode=0, stdout="", stderr="") with patch( - "src.implementation.node_allocation._get_recent_allocation_id", + "slurm_mcp.implementation.node_allocation._get_recent_allocation_id", return_value="12345", ): allocate_nodes(nodes=1, cores=1) diff --git a/clio-kit-mcp-servers/slurm/tests/test_performance.py b/clio-kit-mcp-servers/slurm/tests/test_performance.py index f282c596..6ed811ce 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_performance.py +++ b/clio-kit-mcp-servers/slurm/tests/test_performance.py @@ -12,22 +12,16 @@ import statistics import tempfile import os -import sys import concurrent.futures -from pathlib import Path -from implementation.job_submission import submit_slurm_job -from implementation.job_status import get_job_status -from implementation.job_cancellation import cancel_slurm_job -from implementation.job_listing import list_slurm_jobs -from implementation.cluster_info import get_slurm_info -from implementation.job_details import get_job_details -from implementation.queue_info import get_queue_info -from implementation.array_jobs import submit_array_job -from implementation.node_info import get_node_info - -# Add src to Python path -src_path = Path(__file__).parent.parent / "src" -sys.path.insert(0, str(src_path)) +from slurm_mcp.implementation.job_submission import submit_slurm_job +from slurm_mcp.implementation.job_status import get_job_status +from slurm_mcp.implementation.job_cancellation import cancel_slurm_job +from slurm_mcp.implementation.job_listing import list_slurm_jobs +from slurm_mcp.implementation.cluster_info import get_slurm_info +from slurm_mcp.implementation.job_details import get_job_details +from slurm_mcp.implementation.queue_info import get_queue_info +from slurm_mcp.implementation.array_jobs import submit_array_job +from slurm_mcp.implementation.node_info import get_node_info class TestSlurmMCPPerformance: @@ -167,7 +161,10 @@ def test_job_status_query_performance(self, quick_script): print("\n=== Job Status Query Metrics ===") print(f"Average query latency: {avg_latency:.3f}s") print(f"Max query latency: {max_latency:.3f}s") - print(f"Queries per second: {1 / avg_latency:.1f}") + if avg_latency > 0: + print(f"Queries per second: {1 / avg_latency:.1f}") + else: + print("Queries per second: N/A (latency too small to measure)") # Performance requirements assert avg_latency < 1.0, ( @@ -253,7 +250,10 @@ def test_cluster_info_performance(self): print("\n=== Cluster Info Query Metrics ===") print(f"Average latency: {avg_latency:.3f}s") print(f"Max latency: {max_latency:.3f}s") - print(f"Queries per second: {1 / avg_latency:.1f}") + if avg_latency > 0: + print(f"Queries per second: {1 / avg_latency:.1f}") + else: + print("Queries per second: N/A (latency too small to measure)") # Performance requirements assert avg_latency < 2.0, f"Cluster info query too slow: {avg_latency:.3f}s" @@ -284,7 +284,10 @@ def test_job_listing_performance(self, quick_script): print("\n=== Job Listing Metrics ===") print(f"Average listing latency: {avg_latency:.3f}s") - print(f"Listings per second: {1 / avg_latency:.1f}") + if avg_latency > 0: + print(f"Listings per second: {1 / avg_latency:.1f}") + else: + print("Listings per second: N/A (latency too small to measure)") # Performance requirements assert avg_latency < 3.0, f"Job listing too slow: {avg_latency:.3f}s" @@ -315,7 +318,10 @@ def test_node_info_performance(self): print("\n=== Node Info Query Metrics ===") print(f"Average latency: {avg_latency:.3f}s") - print(f"Queries per second: {1 / avg_latency:.1f}") + if avg_latency > 0: + print(f"Queries per second: {1 / avg_latency:.1f}") + else: + print("Queries per second: N/A (latency too small to measure)") # Performance requirements assert avg_latency < 2.5, f"Node info query too slow: {avg_latency:.3f}s" @@ -338,7 +344,10 @@ def test_queue_info_performance(self): print("\n=== Queue Info Query Metrics ===") print(f"Average latency: {avg_latency:.3f}s") - print(f"Queries per second: {1 / avg_latency:.1f}") + if avg_latency > 0: + print(f"Queries per second: {1 / avg_latency:.1f}") + else: + print("Queries per second: N/A (latency too small to measure)") # Performance requirements assert avg_latency < 2.0, f"Queue info query too slow: {avg_latency:.3f}s" diff --git a/clio-kit-mcp-servers/slurm/tests/test_server_tools.py b/clio-kit-mcp-servers/slurm/tests/test_server_tools.py index 4865223a..8799cba0 100644 --- a/clio-kit-mcp-servers/slurm/tests/test_server_tools.py +++ b/clio-kit-mcp-servers/slurm/tests/test_server_tools.py @@ -6,24 +6,21 @@ import asyncio import pytest import sys -import os from concurrent.futures import ThreadPoolExecutor from unittest.mock import patch, Mock -# Add src to path for imports -sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src")) +from fastmcp.exceptions import ToolError -# Import implementation modules directly -from implementation.job_submission import submit_slurm_job -from implementation.job_status import get_job_status -from implementation.job_cancellation import cancel_slurm_job -from implementation.job_listing import list_slurm_jobs -from implementation.cluster_info import get_slurm_info -from implementation.job_details import get_job_details -from implementation.job_output import get_job_output -from implementation.queue_info import get_queue_info -from implementation.array_jobs import submit_array_job -from implementation.node_info import get_node_info +from slurm_mcp.implementation.job_submission import submit_slurm_job +from slurm_mcp.implementation.job_status import get_job_status +from slurm_mcp.implementation.job_cancellation import cancel_slurm_job +from slurm_mcp.implementation.job_listing import list_slurm_jobs +from slurm_mcp.implementation.cluster_info import get_slurm_info +from slurm_mcp.implementation.job_details import get_job_details +from slurm_mcp.implementation.job_output import get_job_output +from slurm_mcp.implementation.queue_info import get_queue_info +from slurm_mcp.implementation.array_jobs import submit_array_job +from slurm_mcp.implementation.node_info import get_node_info class TestServerTools: @@ -405,7 +402,7 @@ def test_tool_documentation(self): def test_server_import_structure(): """Test that all required imports work.""" - import server + from slurm_mcp import server # Test that all implementation functions are imported required_functions = [ @@ -432,11 +429,11 @@ def test_server_import_structure(): def test_server_logger_and_mcp(): """Test server logger and MCP instance.""" - import server + from slurm_mcp import server # Test logger exists and is configured assert hasattr(server, "logger") - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" # Test MCP instance exists assert hasattr(server, "mcp") @@ -450,26 +447,26 @@ def test_server_logger_and_mcp(): def test_server_main_function(): - """Test main function and argument parsing (lines 881, 937).""" - import server + """Test main function and argument parsing.""" + from slurm_mcp import server - # Test main function with SSE transport + # Test main function with http transport with ( - patch("sys.argv", ["slurm-mcp", "--transport", "sse", "--port", "9000"]), - patch("server.mcp.run") as mock_run, + patch("sys.argv", ["slurm-mcp", "--transport", "http", "--port", "9000"]), + patch.object(server.mcp, "run") as mock_run, patch("builtins.print"), ): try: server.main() # The host defaults to 0.0.0.0, not localhost - mock_run.assert_called_with(transport="sse", host="0.0.0.0", port=9000) + mock_run.assert_called_with(transport="http", host="0.0.0.0", port=9000) except SystemExit: pass # May exit normally # Test main function with stdio transport (default) with ( patch("sys.argv", ["slurm-mcp"]), - patch("server.mcp.run") as mock_run, + patch.object(server.mcp, "run") as mock_run, patch("builtins.print"), ): try: @@ -478,27 +475,21 @@ def test_server_main_function(): except SystemExit: pass # May exit normally - # Test main function error handling (line 937) + # Test main function error handling - exceptions propagate from main() with ( patch("sys.argv", ["slurm-mcp"]), - patch("server.mcp.run", side_effect=Exception("Server error")), + patch.object(server.mcp, "run", side_effect=Exception("Server error")), patch("builtins.print"), - patch("sys.exit") as mock_exit, ): - try: + with pytest.raises(Exception, match="Server error"): server.main() - except SystemExit: - pass # Expected - - # Verify error handling - mock_exit.assert_called_with(1) def test_server_tool_functions_exist(): """Test that tool functions are properly defined.""" - import server + from slurm_mcp import server - # Test that all tool functions exist as attributes + # In FastMCP v3, @mcp.tool() returns the original function tool_functions = [ "submit_slurm_job_tool", "check_job_status_tool", @@ -517,34 +508,34 @@ def test_server_tool_functions_exist(): for func_name in tool_functions: assert hasattr(server, func_name), f"Function {func_name} not found" - # These are FunctionTool objects, not directly callable functions tool_obj = getattr(server, func_name) - assert hasattr(tool_obj, "name"), f"Tool {func_name} missing name attribute" + # In v3, decorated functions are the original async functions + assert callable(tool_obj), f"Tool {func_name} should be callable" def test_server_mcp_registration(): """Test MCP tool registration.""" - import server + from slurm_mcp import server # Test that MCP instance exists and has tools assert server.mcp is not None assert hasattr(server.mcp, "name") - assert server.mcp.name == "Slurm-MCP-JobManagement" + assert server.mcp.name == "slurm" def test_server_logging_configuration(): - """Test logging configuration (lines 56-57).""" - import server + """Test logging configuration.""" + from slurm_mcp import server import logging # Test logger is properly configured assert isinstance(server.logger, logging.Logger) - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" def test_server_tool_error_simulation(): """Test error paths by simulating tool execution errors.""" - import server + from slurm_mcp import server # Test that we can access implementation functions that would be called # This tests the import paths and function availability @@ -564,28 +555,25 @@ def test_server_tool_error_simulation(): def test_server_path_manipulation(): - """Test sys.path manipulation (line 37).""" - import server + """Test that server module is importable (no sys.path manipulation needed).""" + from slurm_mcp import server - # Verify that the current directory was added to sys.path - current_dir = os.path.dirname(server.__file__) - assert current_dir in sys.path + # Verify the server module is importable and has expected attributes + assert hasattr(server, "__file__") + assert server.__file__ is not None def test_server_comprehensive_coverage(): """Comprehensive test to trigger more code paths.""" - import server + from slurm_mcp import server # Test module-level attributes assert hasattr(server, "os") assert hasattr(server, "sys") assert hasattr(server, "logging") - # Test that load_dotenv was attempted - # This would cover the dotenv import block - # Test FastMCP initialization - assert server.mcp.name == "Slurm-MCP-JobManagement" + assert server.mcp.name == "slurm" # Test all implementation imports are successful implementation_modules = [ @@ -615,92 +603,51 @@ def test_server_comprehensive_coverage(): def test_submit_slurm_job_error_handling(): - """Test submit_slurm_job_tool error handling (lines 138-148).""" - import server + """Test submit_slurm_job_tool error handling -- raises ToolError in v3.""" + from slurm_mcp import server # Mock the underlying function to raise an exception - with patch( - "server.submit_slurm_job", side_effect=Exception("Mock submission error") + with patch.object( + server, "submit_slurm_job", side_effect=Exception("Mock submission error") ): - # Get the tool function - it's wrapped by FastMCP - tool_func = server.submit_slurm_job_tool - - # The tool function should have a __wrapped__ attribute or similar - # Let's try to access the original function - if hasattr(tool_func, "func"): - original_func = tool_func.func - elif hasattr(tool_func, "__wrapped__"): - original_func = tool_func.__wrapped__ - else: - # If we can't access the wrapped function, test the import at least - assert tool_func is not None - return - - # Now try to call the original async function + # In v3 the decorator returns the original function, so we can call it directly async def test_error(): - result = await original_func( - script_path="/test/script.sh", - cores=4, - memory="8G", - time_limit="1:00:00", - job_name="test_job", - partition="compute", - ) - - # Check that error handling was triggered - assert "error" in result - assert result["isError"] is True - assert "JobSubmissionError" in str(result) - - # Run the test - try: - asyncio.run(test_error()) - except AttributeError: - # If we can't access the function directly, just verify it exists - assert tool_func is not None + with pytest.raises(ToolError): + await server.submit_slurm_job_tool( + script_path="/test/script.sh", + cores=4, + memory="8G", + time_limit="1:00:00", + job_name="test_job", + partition="compute", + ) + asyncio.run(test_error()) -def test_check_job_status_error_handling(): - """Test check_job_status_tool error handling (lines 215-223).""" - import server - with patch("server.get_job_status", side_effect=Exception("Mock status error")): - tool_func = server.check_job_status_tool +def test_check_job_status_error_handling(): + """Test check_job_status_tool error handling -- raises ToolError in v3.""" + from slurm_mcp import server - if hasattr(tool_func, "func"): - original_func = tool_func.func - elif hasattr(tool_func, "__wrapped__"): - original_func = tool_func.__wrapped__ - else: - assert tool_func is not None - return + with patch.object( + server, "get_job_status", side_effect=Exception("Mock status error") + ): async def test_error(): - result = await original_func(job_id="12345") - assert "error" in result - assert result["isError"] is True - assert "JobStatusError" in str(result) + with pytest.raises(ToolError): + await server.check_job_status_tool(job_id="12345") - try: - asyncio.run(test_error()) - except AttributeError: - assert tool_func is not None + asyncio.run(test_error()) def test_server_tool_inspection(): """Inspect the structure of server tools to understand how to test them.""" - import server + from slurm_mcp import server - # Let's examine the structure of one tool function + # In v3, tools are plain async functions tool = server.submit_slurm_job_tool - - # Check if we can find the original function assert tool is not None - - # Test that the tool has expected attributes - # FastMCP tools should have name, description, etc. - if hasattr(tool, "name"): - assert tool.name is not None + assert callable(tool) # At minimum, verify all tools exist tools = [ @@ -722,13 +669,14 @@ def test_server_tool_inspection(): for tool_name in tools: tool = getattr(server, tool_name) assert tool is not None + assert callable(tool) def test_exception_handling_coverage(): """Test that imports and exception class work properly.""" - import server + from slurm_mcp import server - # Test SlurmMCPError exception (lines 21-23) + # Test SlurmMCPError exception error = server.SlurmMCPError("Test error") assert str(error) == "Test error" assert isinstance(error, Exception) @@ -744,7 +692,7 @@ def test_exception_handling_coverage(): def test_server_basic_structure(): """Basic test to ensure server structure is correct.""" - import server + from slurm_mcp import server # Test that all required components exist assert hasattr(server, "mcp") @@ -753,10 +701,10 @@ def test_server_basic_structure(): assert hasattr(server, "SlurmMCPError") # Test logger configuration - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" # Test MCP instance - assert server.mcp.name == "Slurm-MCP-JobManagement" + assert server.mcp.name == "slurm" # ============================================================================ @@ -768,13 +716,12 @@ def test_server_error_handling_paths(): """Test error handling paths that are currently missing from coverage.""" # Import server to trigger initialization - import server + from slurm_mcp import server # Create mock responses that will trigger error paths Mock(side_effect=Exception("Test error")) # Test that we can access the async function objects - # These are wrapped by FastMCP but we can still inspect them assert hasattr(server, "submit_slurm_job_tool") assert hasattr(server, "check_job_status_tool") assert hasattr(server, "cancel_slurm_job_tool") @@ -791,17 +738,17 @@ def test_server_error_handling_paths(): def test_server_dotenv_import(): - """Test dotenv import path (lines 29-30).""" + """Test dotenv import path.""" # This will trigger the try/except block for dotenv import # by importing server again but mocking the dotenv import to fail with patch.dict("sys.modules", {"dotenv": None}): # Force re-import to trigger the except block - if "server" in sys.modules: - del sys.modules["server"] + if "slurm_mcp.server" in sys.modules: + del sys.modules["slurm_mcp.server"] # Import server which will trigger the dotenv import failure - import server + from slurm_mcp import server # Verify server still works without dotenv assert hasattr(server, "mcp") @@ -810,7 +757,7 @@ def test_server_dotenv_import(): def test_server_main_with_different_args(): """Test main function with different argument combinations.""" - import server + from slurm_mcp import server # Test with --host argument with ( @@ -819,36 +766,36 @@ def test_server_main_with_different_args(): [ "slurm-mcp", "--transport", - "sse", + "http", "--host", "127.0.0.1", "--port", "8080", ], ), - patch("server.mcp.run") as mock_run, + patch.object(server.mcp, "run") as mock_run, ): try: server.main() except SystemExit: pass - mock_run.assert_called_with(transport="sse", host="127.0.0.1", port=8080) + mock_run.assert_called_with(transport="http", host="127.0.0.1", port=8080) # Test with just --host with ( - patch("sys.argv", ["slurm-mcp", "--transport", "sse", "--host", "localhost"]), - patch("server.mcp.run") as mock_run, + patch("sys.argv", ["slurm-mcp", "--transport", "http", "--host", "localhost"]), + patch.object(server.mcp, "run") as mock_run, ): try: server.main() except SystemExit: pass - mock_run.assert_called_with(transport="sse", host="localhost", port=8000) + mock_run.assert_called_with(transport="http", host="localhost", port=8000) def test_server_exception_class(): - """Test SlurmMCPError exception class (lines 21-23).""" - import server + """Test SlurmMCPError exception class.""" + from slurm_mcp import server # Test exception creation and string representation error = server.SlurmMCPError("Test error message") @@ -866,12 +813,12 @@ def test_server_exception_class(): def test_server_logging_setup(): """Test logging setup and configuration.""" - import server + from slurm_mcp import server import logging # Verify logger configuration assert isinstance(server.logger, logging.Logger) - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" # Test that we can log messages (this exercises logging setup) server.logger.info("Test log message") @@ -880,17 +827,17 @@ def test_server_logging_setup(): def test_server_sys_path_modification(): - """Test sys.path modification (line 37).""" - import server + """Test server module is properly importable (no sys.path manipulation).""" + from slurm_mcp import server - # The import of server should have added the current directory to sys.path - server_dir = os.path.dirname(server.__file__) - assert server_dir in sys.path + # The server module should be importable without sys.path manipulation + assert hasattr(server, "__file__") + assert server.__file__ is not None def test_server_implementation_imports(): """Test that all implementation imports work correctly.""" - import server + from slurm_mcp import server # Test that all implementation functions are accessible implementation_functions = [ @@ -917,12 +864,12 @@ def test_server_implementation_imports(): def test_server_fastmcp_initialization(): """Test FastMCP initialization and tool registration.""" - import server + from slurm_mcp import server # Test FastMCP instance assert server.mcp is not None assert hasattr(server.mcp, "name") - assert server.mcp.name == "Slurm-MCP-JobManagement" + assert server.mcp.name == "slurm" # Test that mcp has expected methods assert hasattr(server.mcp, "run") @@ -931,7 +878,7 @@ def test_server_fastmcp_initialization(): def test_server_module_level_variables(): """Test module-level variables and imports.""" - import server + from slurm_mcp import server # Test required imports are available assert hasattr(server, "os") @@ -941,56 +888,51 @@ def test_server_module_level_variables(): # Test FastMCP-related imports assert hasattr(server, "FastMCP") + # Test ToolError import + assert hasattr(server, "ToolError") + + # Test Message import + assert hasattr(server, "Message") + # Test that server has the expected structure assert hasattr(server, "main") assert callable(server.main) -# ============================================================================ -# ADDITIONAL SERVER COVERAGE TESTS TO IMPROVE MISSING LINES -# ============================================================================ - - def test_server_missing_lines_coverage(): """Test server.py missing lines to improve coverage.""" - import server + from slurm_mcp import server - # Test main function with detailed argument handling (lines 881, 937) - # Test SSE transport with custom host and port + # Test main function with detailed argument handling + # Test HTTP transport with custom host and port with patch( "sys.argv", - ["slurm-mcp", "--transport", "sse", "--host", "0.0.0.0", "--port", "9000"], + ["slurm-mcp", "--transport", "http", "--host", "0.0.0.0", "--port", "9000"], ): - with patch("server.mcp.run") as mock_run: + with patch.object(server.mcp, "run") as mock_run: with patch("builtins.print"): try: server.main() except SystemExit: pass # Should be called with specific host and port - mock_run.assert_called_with(transport="sse", host="0.0.0.0", port=9000) + mock_run.assert_called_with(transport="http", host="0.0.0.0", port=9000) - # Test main function exception handling (line 937) - with patch("sys.argv", ["slurm-mcp"]): - with patch("server.mcp.run", side_effect=Exception("Server startup failed")): - with patch("builtins.print"): - with patch("sys.exit") as mock_exit: - try: - server.main() - except SystemExit: - pass - except Exception: - pass - - # Verify error handling was triggered - mock_exit.assert_called_with(1) + # Test main function exception handling - exceptions propagate from main() + with ( + patch("sys.argv", ["slurm-mcp"]), + patch.object(server.mcp, "run", side_effect=Exception("Server startup failed")), + patch("builtins.print"), + ): + with pytest.raises(Exception, match="Server startup failed"): + server.main() def test_server_tool_error_paths(): """Test error handling paths in server tool functions.""" - import server + from slurm_mcp import server - # Test all tool functions exist and are callable + # In v3, tool functions are the original async functions tool_functions = [ "submit_slurm_job_tool", "check_job_status_tool", @@ -1010,81 +952,152 @@ def test_server_tool_error_paths(): for tool_name in tool_functions: tool = getattr(server, tool_name) assert tool is not None - - # Test that the tool has expected FastMCP attributes - if hasattr(tool, "name"): - assert isinstance(tool.name, str) - if hasattr(tool, "description"): - assert isinstance(tool.description, str) + assert callable(tool) def test_server_async_error_handling(): - """Test async function error handling paths in server tools.""" - import server + """Test async function error handling paths in server tools -- ToolError in v3.""" + from slurm_mcp import server - # Mock underlying functions to raise exceptions - with patch( - "server.submit_slurm_job", side_effect=Exception("Job submission failed") + # Mock underlying functions to raise exceptions and verify ToolError + # Use patch.object to ensure correct module-level name replacement + with patch.object( + server, "submit_slurm_job", side_effect=Exception("Job submission failed") ): - # Test that we can access the tool (though we can't easily call the async function) - tool = server.submit_slurm_job_tool - assert tool is not None - with patch("server.get_job_status", side_effect=Exception("Status check failed")): - tool = server.check_job_status_tool - assert tool is not None + async def _test(): + with pytest.raises(ToolError): + await server.submit_slurm_job_tool(script_path="/test.sh", cores=1) - with patch("server.cancel_slurm_job", side_effect=Exception("Cancellation failed")): - tool = server.cancel_slurm_job_tool - assert tool is not None + asyncio.run(_test()) - with patch("server.list_slurm_jobs", side_effect=Exception("Listing failed")): - tool = server.list_slurm_jobs_tool - assert tool is not None + with patch.object( + server, "get_job_status", side_effect=Exception("Status check failed") + ): - with patch("server.get_slurm_info", side_effect=Exception("Info retrieval failed")): - tool = server.get_slurm_info_tool - assert tool is not None + async def _test(): + with pytest.raises(ToolError): + await server.check_job_status_tool(job_id="123") - with patch("server.get_job_details", side_effect=Exception("Details failed")): - tool = server.get_job_details_tool - assert tool is not None + asyncio.run(_test()) - with patch("server.get_job_output", side_effect=Exception("Output failed")): - tool = server.get_job_output_tool - assert tool is not None + with patch.object( + server, "cancel_slurm_job", side_effect=Exception("Cancellation failed") + ): - with patch("server.get_queue_info", side_effect=Exception("Queue info failed")): - tool = server.get_queue_info_tool - assert tool is not None + async def _test(): + with pytest.raises(ToolError): + await server.cancel_slurm_job_tool(job_id="123") - with patch("server.submit_array_job", side_effect=Exception("Array job failed")): - tool = server.submit_array_job_tool - assert tool is not None + asyncio.run(_test()) - with patch("server.get_node_info", side_effect=Exception("Node info failed")): - tool = server.get_node_info_tool - assert tool is not None + with patch.object( + server, "list_slurm_jobs", side_effect=Exception("Listing failed") + ): - with patch("server.allocate_nodes", side_effect=Exception("Allocation failed")): - tool = server.allocate_slurm_nodes_tool - assert tool is not None + async def _test(): + with pytest.raises(ToolError): + await server.list_slurm_jobs_tool() - with patch("server.deallocate_nodes", side_effect=Exception("Deallocation failed")): - tool = server.deallocate_slurm_nodes_tool - assert tool is not None + asyncio.run(_test()) - with patch("server.get_allocation_status", side_effect=Exception("Status failed")): - tool = server.get_allocation_status_tool - assert tool is not None + with patch.object( + server, "get_slurm_info", side_effect=Exception("Info retrieval failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.get_slurm_info_tool() + + asyncio.run(_test()) + + with patch.object( + server, "get_job_details", side_effect=Exception("Details failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.get_job_details_tool(job_id="123") + + asyncio.run(_test()) + + with patch.object(server, "get_job_output", side_effect=Exception("Output failed")): + + async def _test(): + with pytest.raises(ToolError): + await server.get_job_output_tool(job_id="123") + + asyncio.run(_test()) + + with patch.object( + server, "get_queue_info", side_effect=Exception("Queue info failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.get_queue_info_tool() + + asyncio.run(_test()) + + with patch.object( + server, "submit_array_job", side_effect=Exception("Array job failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.submit_array_job_tool( + script_path="/test.sh", array_range="1-5" + ) + + asyncio.run(_test()) + + with patch.object( + server, "get_node_info", side_effect=Exception("Node info failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.get_node_info_tool() + + asyncio.run(_test()) + + with patch.object( + server, "allocate_nodes", side_effect=Exception("Allocation failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.allocate_slurm_nodes_tool() + + asyncio.run(_test()) + + with patch.object( + server, "deallocate_nodes", side_effect=Exception("Deallocation failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.deallocate_slurm_nodes_tool(allocation_id="123") + + asyncio.run(_test()) + + with patch.object( + server, "get_allocation_status", side_effect=Exception("Status failed") + ): + + async def _test(): + with pytest.raises(ToolError): + await server.get_allocation_status_tool(allocation_id="123") + + asyncio.run(_test()) def test_server_edge_cases(): """Test edge cases and additional server functionality.""" - import server + from slurm_mcp import server # Test logger configuration (already done in other tests but verify again) - assert server.logger.name == "server" + assert server.logger.name == "slurm_mcp.server" # Test that all implementation functions are imported correctly impl_functions = [ @@ -1115,53 +1128,55 @@ def test_server_edge_cases(): def test_server_main_with_stdio_transport(): """Test main function with default stdio transport.""" - import server + from slurm_mcp import server # Test stdio transport (default) - with patch("sys.argv", ["slurm-mcp"]): - with patch("server.mcp.run") as mock_run: - with patch("builtins.print"): - try: - server.main() - except SystemExit: - pass - mock_run.assert_called_with(transport="stdio") + with ( + patch("sys.argv", ["slurm-mcp"]), + patch.object(server.mcp, "run") as mock_run, + patch("builtins.print"), + ): + try: + server.main() + except SystemExit: + pass + mock_run.assert_called_with(transport="stdio") def test_server_main_with_sse_host_variations(): - """Test main function with SSE transport and different host configurations.""" - import server + """Test main function with HTTP transport and different host configurations.""" + from slurm_mcp import server - # Test SSE with default host (0.0.0.0) and custom port - with patch("sys.argv", ["slurm-mcp", "--transport", "sse", "--port", "8080"]): - with patch("server.mcp.run") as mock_run: + # Test HTTP with default host (0.0.0.0) and custom port + with patch("sys.argv", ["slurm-mcp", "--transport", "http", "--port", "8080"]): + with patch.object(server.mcp, "run") as mock_run: with patch("builtins.print"): try: server.main() except SystemExit: pass - mock_run.assert_called_with(transport="sse", host="0.0.0.0", port=8080) + mock_run.assert_called_with(transport="http", host="0.0.0.0", port=8080) - # Test SSE with custom host and default port - with patch("sys.argv", ["slurm-mcp", "--transport", "sse", "--host", "localhost"]): - with patch("server.mcp.run") as mock_run: + # Test HTTP with custom host and default port + with patch("sys.argv", ["slurm-mcp", "--transport", "http", "--host", "localhost"]): + with patch.object(server.mcp, "run") as mock_run: with patch("builtins.print"): try: server.main() except SystemExit: pass mock_run.assert_called_with( - transport="sse", host="localhost", port=8000 + transport="http", host="localhost", port=8000 ) def test_server_imports_and_path_setup(): - """Test server imports and sys.path setup.""" - import server + """Test server imports and module setup.""" + from slurm_mcp import server - # Test that server directory is in sys.path (line 37) - server_dir = os.path.dirname(server.__file__) - assert server_dir in sys.path + # Test that server module is properly importable + assert hasattr(server, "__file__") + assert server.__file__ is not None # Test FastMCP import success assert hasattr(server, "FastMCP") @@ -1171,19 +1186,15 @@ def test_server_imports_and_path_setup(): assert hasattr(server, "sys") assert hasattr(server, "logging") - # Test optional dotenv import (doesn't raise if missing) - # This is hard to test since dotenv is imported at module level - def test_server_mcp_configuration(): """Test MCP instance configuration and tool registration.""" - import server + from slurm_mcp import server # Test MCP instance configuration - assert server.mcp.name == "Slurm-MCP-JobManagement" + assert server.mcp.name == "slurm" - # Test that all tools are registered (we can't easily access them directly) - # but we can verify the tool objects exist + # In v3, tool functions are just async callables expected_tools = [ "submit_slurm_job_tool", "check_job_status_tool", @@ -1204,3 +1215,22 @@ def test_server_mcp_configuration(): assert hasattr(server, tool_name) tool = getattr(server, tool_name) assert tool is not None + assert callable(tool) + + +def test_server_resource_and_prompt(): + """Test that the resource and prompt are registered.""" + from slurm_mcp import server + + # Test cluster_info resource function + assert hasattr(server, "cluster_info") + result = server.cluster_info() + assert isinstance(result, dict) + assert result["scheduler"] == "slurm" + assert "operations" in result + + # Test submit_job_workflow prompt function + assert hasattr(server, "submit_job_workflow") + messages = server.submit_job_workflow("/path/to/script.sh") + assert isinstance(messages, list) + assert len(messages) == 1 diff --git a/clio-kit-website/docs/mcps/adios.md b/clio-kit-website/docs/mcps/adios.md index 6d3904fa..4356a1fc 100644 --- a/clio-kit-website/docs/mcps/adios.md +++ b/clio-kit-website/docs/mcps/adios.md @@ -1,7 +1,6 @@ --- title: Adios MCP description: "ADIOS MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 5 tools for ADIOS2 BP5 file access: list files, inspect variables, read data at specific steps, extract attributes. Enables AI agents to work with high-performance scientific data formats." -hide_table_of_contents: true --- import MCPDetail from '@site/src/components/MCPDetail'; @@ -12,11 +11,11 @@ import MCPDetail from '@site/src/components/MCPDetail'; category="Data Processing" description="ADIOS MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 5 tools for ADIOS2 BP5 file access: list files, inspect variables, read data at specific steps, extract attributes. Enables AI agents to work with high-performance scientific data formats." version="1.0.0" - actions={["list_bp5", "inspect_variables", "inspect_variables_at_step", "inspect_attributes", "read_variable_at_step"]} + actions={[]} platforms={["claude", "cursor", "vscode"]} keywords={["mcp", "adios2", "bp5", "scientific data", "data access", "variable inspection", "attribute extraction", "iowarp", "grc"]} - license="MIT" - tools={[{"name": "list_bp5", "description": "Lists all BP5 files in a given directory, the bp5 files are actually directories so both file and directory words are correct. The 'directory' parameter must be an absolute path.", "function_name": "list_bp5_tool"}, {"name": "inspect_variables", "description": "Inspects variables in a BP5 file. If variable_name is provided, returns data for that specific variable. Otherwise, shows type, shape, and steps for all variables. The 'filename' parameter must be an absolute path to the BP5 file.", "function_name": "inspect_variables_tool"}, {"name": "inspect_variables_at_step", "description": "Inspects a specific variable at a given step in a BP5 file. Shows variable type, shape, min, max. All parameters are required. The 'filename' must be an absolute path.", "function_name": "inspect_variables_at_step_tool"}, {"name": "inspect_attributes", "description": "Reads global or variable-specific attributes from a BP5 file. The 'filename' parameter must be an absolute path. The 'variable_name' is optional.", "function_name": "inspect_attributes_tool"}, {"name": "read_variable_at_step", "description": "Reads a named variable at a specific step from a BP5 file. All parameters are required. The 'filename' must be an absolute path.", "function_name": "read_variable_at_step_tool"}]} + license="BSD-3-Clause" + tools={[]} > ### 1. Scientific Data Structure Analysis diff --git a/clio-kit-website/docs/mcps/arxiv.md b/clio-kit-website/docs/mcps/arxiv.md index e951efbf..a0869a81 100644 --- a/clio-kit-website/docs/mcps/arxiv.md +++ b/clio-kit-website/docs/mcps/arxiv.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["search_arxiv", "get_recent_papers", "search_papers_by_author", "search_by_title", "search_by_abstract", "search_by_subject", "search_date_range", "get_paper_details", "export_to_bibtex", "find_similar_papers", "download_paper_pdf", "get_pdf_url", "download_multiple_pdfs"]} platforms={["claude", "cursor", "vscode"]} keywords={["data processing", "arxiv", "publications", "scientific data", "research", "papers", "iowarp", "grc"]} - license="MIT" - tools={[{"name": "search_arxiv", "description": "Search ArXiv for research papers by category or topic.", "function_name": "search_arxiv_tool"}, {"name": "get_recent_papers", "description": "Get recent papers from a specific ArXiv category.", "function_name": "get_recent_papers_tool"}, {"name": "search_papers_by_author", "description": "Search ArXiv papers by author name.", "function_name": "search_papers_by_author_tool"}, {"name": "search_by_title", "description": "Search ArXiv papers by title keywords.", "function_name": "search_by_title_tool"}, {"name": "search_by_abstract", "description": "Search ArXiv papers by abstract keywords.", "function_name": "search_by_abstract_tool"}, {"name": "search_by_subject", "description": "Search ArXiv papers by subject classification.", "function_name": "search_by_subject_tool"}, {"name": "search_date_range", "description": "Search ArXiv papers within a specific date range.", "function_name": "search_date_range_tool"}, {"name": "get_paper_details", "description": "Get detailed information about a specific ArXiv paper by ID.", "function_name": "get_paper_details_tool"}, {"name": "export_to_bibtex", "description": "Export search results to BibTeX format for citation management.", "function_name": "export_to_bibtex_tool"}, {"name": "find_similar_papers", "description": "Find papers similar to a reference paper based on categories and keywords.", "function_name": "find_similar_papers_tool"}, {"name": "download_paper_pdf", "description": "Download the PDF of a paper from ArXiv.", "function_name": "download_paper_pdf_tool"}, {"name": "get_pdf_url", "description": "Get the direct PDF URL for a paper without downloading.", "function_name": "get_pdf_url_tool"}, {"name": "download_multiple_pdfs", "description": "Download multiple PDFs concurrently with rate limiting.", "function_name": "download_multiple_pdfs_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "search_arxiv", "description": "Search ArXiv for papers by category or topic.", "function_name": "search_arxiv"}, {"name": "get_recent_papers", "description": "Get recent papers from a specific ArXiv category.", "function_name": "get_recent_papers"}, {"name": "search_papers_by_author", "description": "Search ArXiv papers by author name.", "function_name": "search_papers_by_author"}, {"name": "search_by_title", "description": "Search ArXiv papers by title keywords.", "function_name": "search_by_title"}, {"name": "search_by_abstract", "description": "Search ArXiv papers by abstract keywords.", "function_name": "search_by_abstract"}, {"name": "search_by_subject", "description": "Search ArXiv papers by subject classification.", "function_name": "search_by_subject"}, {"name": "search_date_range", "description": "Search ArXiv papers within a specific date range.", "function_name": "search_date_range"}, {"name": "get_paper_details", "description": "Get detailed information about a specific ArXiv paper by ID.", "function_name": "get_paper_details"}, {"name": "export_to_bibtex", "description": "Export search results to BibTeX format for citation management.", "function_name": "export_to_bibtex"}, {"name": "find_similar_papers", "description": "Find papers similar to a reference paper based on categories and keywords.", "function_name": "find_similar_papers"}, {"name": "download_paper_pdf", "description": "Download the PDF of a paper from ArXiv.", "function_name": "download_paper_pdf"}, {"name": "get_pdf_url", "description": "Get the direct PDF URL for a paper without downloading.", "function_name": "get_pdf_url"}, {"name": "download_multiple_pdfs", "description": "Download multiple PDFs concurrently with rate limiting.", "function_name": "download_multiple_pdfs"}]} > ### 1. Academic Research Discovery diff --git a/clio-kit-website/docs/mcps/chronolog.md b/clio-kit-website/docs/mcps/chronolog.md index f4935740..c02a869a 100644 --- a/clio-kit-website/docs/mcps/chronolog.md +++ b/clio-kit-website/docs/mcps/chronolog.md @@ -11,11 +11,11 @@ import MCPDetail from '@site/src/components/MCPDetail'; category="Data Processing" description="Chronolog MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 4 tools for distributed logging: start sessions, record interactions, retrieve history. Enables AI agents to log and track interactions on HPC systems." version="1.0.0" - actions={["start_chronolog", "record_interaction", "stop_chronolog", "retrieve_interaction"]} + actions={[]} platforms={["claude", "cursor", "vscode"]} keywords={["distributed logging", "chronolog", "event logging", "session management", "context sharing", "real-time", "model context protocol", "scientific data", "conversational ai", "high-performance", "shared log", "multi-client", "historical retrieval", "enterprise logging"]} - license="MIT" - tools={[{"name": "start_chronolog", "description": "Connects to ChronoLog, creates a chronicle, and acquires a story handle for logging interactions.", "function_name": "start_chronolog"}, {"name": "record_interaction", "description": "Logs user messages and LLM responses to the active story with structured event formatting.", "function_name": "record_interaction"}, {"name": "stop_chronolog", "description": "Releases the story handle and cleanly disconnects from ChronoLog system.", "function_name": "stop_chronolog"}, {"name": "retrieve_interaction", "description": "Extracts logged records from specified chronicle and story, generates timestamped output files with filtering options.", "function_name": "retrieve_interaction"}]} + license="BSD-3-Clause" + tools={[]} > ### 1. Session Logging and Analysis diff --git a/clio-kit-website/docs/mcps/compression.md b/clio-kit-website/docs/mcps/compression.md index 3e56087f..3684f3bf 100644 --- a/clio-kit-website/docs/mcps/compression.md +++ b/clio-kit-website/docs/mcps/compression.md @@ -11,11 +11,11 @@ import MCPDetail from '@site/src/components/MCPDetail'; category="Utilities" description="Compression MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). GZIP file compression tool for storage optimization, archival, and network transfer. Enables AI agents to compress files efficiently." version="1.0.0" - actions={["compress_file"]} + actions={["compress_file_tool", "decompress_file_tool"]} platforms={["claude", "cursor", "vscode"]} keywords={["compression", "gzip", "storage", "archival", "backup", "analytics", "statistics"]} - license="MIT" - tools={[{"name": "compress_file", "description": "Compress a file using gzip compression.", "function_name": "compress_file_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "compress_file_tool", "description": "Compress a file using gzip. Returns original/compressed sizes and compression ratio.", "function_name": "compress_file_tool"}, {"name": "decompress_file_tool", "description": "Decompress a gzip-compressed (.gz) file back to its original form.", "function_name": "decompress_file_tool"}]} > ### 1. Log File Compression and Storage Optimization diff --git a/clio-kit-website/docs/mcps/darshan.md b/clio-kit-website/docs/mcps/darshan.md index 9fd8e8db..897b3663 100644 --- a/clio-kit-website/docs/mcps/darshan.md +++ b/clio-kit-website/docs/mcps/darshan.md @@ -11,11 +11,11 @@ import MCPDetail from '@site/src/components/MCPDetail'; category="Analysis & Visualization" description="Darshan MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 10 tools for I/O performance analysis: load traces, analyze access patterns, identify bottlenecks, compare logs. Enables AI agents to analyze HPC application I/O performance." version="1.0.0" - actions={["load_darshan_log", "get_job_summary", "analyze_file_access_patterns", "get_io_performance_metrics", "analyze_posix_operations", "analyze_mpiio_operations", "identify_io_bottlenecks", "get_timeline_analysis", "compare_darshan_logs", "generate_io_summary_report", "load_darshan_log", "get_job_summary", "analyze_file_access_patterns", "get_io_performance_metrics", "analyze_posix_operations", "analyze_mpiio_operations", "identify_io_bottlenecks", "get_timeline_analysis", "compare_darshan_logs", "generate_io_summary_report"]} + actions={["load_darshan_log", "get_job_summary", "analyze_file_access_patterns", "get_io_performance_metrics", "analyze_posix_operations", "analyze_mpiio_operations", "identify_io_bottlenecks", "get_timeline_analysis", "compare_darshan_logs", "generate_io_summary_report"]} platforms={["claude", "cursor", "vscode"]} keywords={["darshan", "i/o profiling", "performance analysis", "hpc", "mcp", "iowarp", "grc"]} - license="MIT" - tools={[{"name": "load_darshan_log", "description": "Load and parse a Darshan log file to extract I/O performance metrics and metadata. Returns basic information about the trace file including job details, file access patterns, and available modules.", "function_name": "load_darshan_log_tool"}, {"name": "get_job_summary", "description": "Get comprehensive job-level summary from a loaded Darshan log including execution time, number of processes, total I/O volume, and performance metrics.", "function_name": "get_job_summary_tool"}, {"name": "analyze_file_access_patterns", "description": "Analyze file access patterns from the trace including which files were accessed, access types (read/write), sequential vs random access patterns, and file size distributions.", "function_name": "analyze_file_access_patterns_tool"}, {"name": "get_io_performance_metrics", "description": "Extract detailed I/O performance metrics including bandwidth, IOPS, average request sizes, and timing information for read and write operations.", "function_name": "get_io_performance_metrics_tool"}, {"name": "analyze_posix_operations", "description": "Analyze POSIX I/O operations from the trace including read/write system calls, file operations (open, close, seek), and their frequency and timing patterns.", "function_name": "analyze_posix_operations_tool"}, {"name": "analyze_mpiio_operations", "description": "Analyze MPI-IO operations if present in the trace, including collective vs independent operations, file view usage, and MPI-IO specific performance metrics.", "function_name": "analyze_mpiio_operations_tool"}, {"name": "identify_io_bottlenecks", "description": "Identify potential I/O performance bottlenecks by analyzing access patterns, file system usage, small vs large I/O operations, and synchronization patterns.", "function_name": "identify_io_bottlenecks_tool"}, {"name": "get_timeline_analysis", "description": "Generate timeline analysis showing I/O activity over time, including peak I/O periods, idle times, and temporal patterns in file access.", "function_name": "get_timeline_analysis_tool"}, {"name": "compare_darshan_logs", "description": "Compare two Darshan log files to identify differences in I/O patterns, performance changes, and behavioral variations between different runs or configurations.", "function_name": "compare_darshan_logs_tool"}, {"name": "generate_io_summary_report", "description": "Generate a comprehensive I/O summary report combining all analysis results into a human-readable format with key findings, performance insights, and recommendations.", "function_name": "generate_io_summary_report_tool"}, {"name": "load_darshan_log", "description": "Load and parse a Darshan log file to extract I/O performance metrics and metadata. Returns basic information about the trace file including job details, file access patterns, and available modules.", "function_name": "load_darshan_log_tool"}, {"name": "get_job_summary", "description": "Get comprehensive job-level summary from a loaded Darshan log including execution time, number of processes, total I/O volume, and performance metrics.", "function_name": "get_job_summary_tool"}, {"name": "analyze_file_access_patterns", "description": "Analyze file access patterns from the trace including which files were accessed, access types (read/write), sequential vs random access patterns, and file size distributions.", "function_name": "analyze_file_access_patterns_tool"}, {"name": "get_io_performance_metrics", "description": "Extract detailed I/O performance metrics including bandwidth, IOPS, average request sizes, and timing information for read and write operations.", "function_name": "get_io_performance_metrics_tool"}, {"name": "analyze_posix_operations", "description": "Analyze POSIX I/O operations from the trace including read/write system calls, file operations (open, close, seek), and their frequency and timing patterns.", "function_name": "analyze_posix_operations_tool"}, {"name": "analyze_mpiio_operations", "description": "Analyze MPI-IO operations if present in the trace, including collective vs independent operations, file view usage, and MPI-IO specific performance metrics.", "function_name": "analyze_mpiio_operations_tool"}, {"name": "identify_io_bottlenecks", "description": "Identify potential I/O performance bottlenecks by analyzing access patterns, file system usage, small vs large I/O operations, and synchronization patterns.", "function_name": "identify_io_bottlenecks_tool"}, {"name": "get_timeline_analysis", "description": "Generate timeline analysis showing I/O activity over time, including peak I/O periods, idle times, and temporal patterns in file access.", "function_name": "get_timeline_analysis_tool"}, {"name": "compare_darshan_logs", "description": "Compare two Darshan log files to identify differences in I/O patterns, performance changes, and behavioral variations between different runs or configurations.", "function_name": "compare_darshan_logs_tool"}, {"name": "generate_io_summary_report", "description": "Generate a comprehensive I/O summary report combining all analysis results into a human-readable format with key findings, performance insights, and recommendations.", "function_name": "generate_io_summary_report_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "load_darshan_log", "description": "Load and parse a Darshan log file to extract I/O performance metrics and metadata.", "function_name": "load_darshan_log"}, {"name": "get_job_summary", "description": "Get job-level summary from a Darshan log including runtime, process count, and I/O volume.", "function_name": "get_job_summary"}, {"name": "analyze_file_access_patterns", "description": "Analyze file access patterns including read/write types and sequential vs random access.", "function_name": "analyze_file_access_patterns"}, {"name": "get_io_performance_metrics", "description": "Extract I/O performance metrics including bandwidth, IOPS, and request sizes.", "function_name": "get_io_performance_metrics"}, {"name": "analyze_posix_operations", "description": "Analyze POSIX I/O operations including read/write system calls and their frequency.", "function_name": "analyze_posix_operations"}, {"name": "analyze_mpiio_operations", "description": "Analyze MPI-IO operations including collective vs independent operations.", "function_name": "analyze_mpiio_operations"}, {"name": "identify_io_bottlenecks", "description": "Identify I/O performance bottlenecks by analyzing access patterns and operations.", "function_name": "identify_io_bottlenecks"}, {"name": "get_timeline_analysis", "description": "Generate timeline analysis showing I/O activity over time and temporal patterns.", "function_name": "get_timeline_analysis"}, {"name": "compare_darshan_logs", "description": "Compare two Darshan log files to identify performance differences between runs.", "function_name": "compare_darshan_logs"}, {"name": "generate_io_summary_report", "description": "Generate a comprehensive I/O summary report with findings and recommendations.", "function_name": "generate_io_summary_report"}]} > ### 1. HPC Application Performance Analysis diff --git a/clio-kit-website/docs/mcps/hdf5.md b/clio-kit-website/docs/mcps/hdf5.md index 7a7f3400..5ead67df 100644 --- a/clio-kit-website/docs/mcps/hdf5.md +++ b/clio-kit-website/docs/mcps/hdf5.md @@ -1,6 +1,6 @@ --- title: Hdf5 MCP -description: "HDF5 MCP v1.0.0 (Flagship) - Part of CLIO Kit (IoWarp Platform). 27 tools for HDF5 scientific data with AI-powered insights, parallel processing (4-8x speedup), LRU caching (100-1000x speedup), streaming for large datasets. Latest FastMCP 2.12.5, h5py 3.15.1, full MCP protocol compliance. Exem..." +description: "HDF5 MCP v1.0.0 (Flagship) - Part of CLIO Kit (IoWarp Platform). 27 tools for HDF5 scientific data with AI-powered insights, parallel processing (4-8x speedup), LRU caching (100-1000x speedup), streaming for large datasets. Latest FastMCP 2.12.5, h5py 3.15.1, full MCP protocol compliance. Exempla..." --- import MCPDetail from '@site/src/components/MCPDetail'; @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["open_file", "close_file", "get_filename", "get_mode", "get_by_path", "list_keys", "visit", "read_full_dataset", "read_partial_dataset", "get_shape", "get_dtype", "get_size", "get_chunks", "read_attribute", "list_attributes", "hdf5_parallel_scan", "hdf5_batch_read", "hdf5_stream_data", "hdf5_aggregate_stats", "analyze_dataset_structure", "find_similar_datasets", "suggest_next_exploration", "identify_io_bottlenecks", "optimize_access_pattern", "refresh_hdf5_resources", "list_available_hdf5_files", "export_dataset"]} platforms={["claude", "cursor", "vscode"]} keywords={["hdf5", "scientific-data", "hierarchical-data", "data-analysis", "scientific-computing", "mcp", "llm-integration", "data-structures"]} - license="MIT" - tools={[{"name": "open_file", "description": "Open an HDF5 file for operations.", "function_name": "open_file"}, {"name": "close_file", "description": "Close the current HDF5 file.", "function_name": "close_file"}, {"name": "get_filename", "description": "Get the current file's path.", "function_name": "get_filename"}, {"name": "get_mode", "description": "Get the current file's access mode.", "function_name": "get_mode"}, {"name": "get_by_path", "description": "Get a dataset or group by path.", "function_name": "get_by_path"}, {"name": "list_keys", "description": "List keys in a group.", "function_name": "list_keys"}, {"name": "visit", "description": "Visit all nodes recursively.", "function_name": "visit"}, {"name": "read_full_dataset", "description": "Read an entire dataset with efficient chunked reading for large datasets.", "function_name": "read_full_dataset"}, {"name": "read_partial_dataset", "description": "Read a portion of a dataset with slicing.", "function_name": "read_partial_dataset"}, {"name": "get_shape", "description": "Get the shape of a dataset.", "function_name": "get_shape"}, {"name": "get_dtype", "description": "Get the data type of a dataset.", "function_name": "get_dtype"}, {"name": "get_size", "description": "Get the size of a dataset.", "function_name": "get_size"}, {"name": "get_chunks", "description": "Get chunk information for a dataset.", "function_name": "get_chunks"}, {"name": "read_attribute", "description": "Read an attribute from an object.", "function_name": "read_attribute"}, {"name": "list_attributes", "description": "List all attributes of an object.", "function_name": "list_attributes"}, {"name": "hdf5_parallel_scan", "description": "Fast multi-file scanning with parallel processing.", "function_name": "hdf5_parallel_scan"}, {"name": "hdf5_batch_read", "description": "Read multiple datasets in parallel.", "function_name": "hdf5_batch_read"}, {"name": "hdf5_stream_data", "description": "Stream large datasets efficiently with memory management.", "function_name": "hdf5_stream_data"}, {"name": "hdf5_aggregate_stats", "description": "Parallel statistics computation across multiple datasets.", "function_name": "hdf5_aggregate_stats"}, {"name": "analyze_dataset_structure", "description": "Analyze and understand file organization and data patterns with AI insights.", "function_name": "analyze_dataset_structure"}, {"name": "find_similar_datasets", "description": "Find datasets with similar characteristics to a reference dataset with AI analysis.", "function_name": "find_similar_datasets"}, {"name": "suggest_next_exploration", "description": "Suggest interesting data to explore next based on current location with AI recommendations.", "function_name": "suggest_next_exploration"}, {"name": "identify_io_bottlenecks", "description": "Identify potential I/O bottlenecks and performance issues with AI recommendations.", "function_name": "identify_io_bottlenecks"}, {"name": "optimize_access_pattern", "description": "Suggest better approaches for data access based on usage patterns.", "function_name": "optimize_access_pattern"}, {"name": "refresh_hdf5_resources", "description": "Re-scan client roots and update available HDF5 resources.", "function_name": "refresh_hdf5_resources"}, {"name": "list_available_hdf5_files", "description": "List all registered HDF5 files with resource URIs for Claude Code @ mentions.", "function_name": "list_available_hdf5_files"}, {"name": "export_dataset", "description": "Export dataset to various formats with user format selection.", "function_name": "export_dataset"}]} + license="BSD-3-Clause" + tools={[{"name": "open_file", "description": "Open an HDF5 file for operations.\n\nArgs:\n path: Path to HDF5 file\n mode: File access mode ('r', 'r+', 'w', 'a')\n\nReturns:\n Success message with file info", "function_name": "open_file"}, {"name": "close_file", "description": "Close the current HDF5 file.\n\nReturns:\n Status message", "function_name": "close_file"}, {"name": "get_filename", "description": "Get the current file's path.\n\nReturns:\n File path", "function_name": "get_filename"}, {"name": "get_mode", "description": "Get the current file's access mode.\n\nReturns:\n File mode", "function_name": "get_mode"}, {"name": "get_by_path", "description": "Get a dataset or group by path.\n\nArgs:\n path: Path to object within file\n\nReturns:\n Object information", "function_name": "get_by_path"}, {"name": "list_keys", "description": "List keys in a group.\n\nArgs:\n path: Path to group (default: root)\n\nReturns:\n JSON array of keys", "function_name": "list_keys"}, {"name": "visit", "description": "Visit all nodes recursively.\n\nArgs:\n callback_fn: Callback function name (currently collects all paths)\n\nReturns:\n JSON array of all paths and types", "function_name": "visit"}, {"name": "read_full_dataset", "description": "Read an entire dataset with efficient chunked reading for large datasets.\n\nArgs:\n path: Path to dataset within file\n\nReturns:\n Dataset description", "function_name": "read_full_dataset"}, {"name": "read_partial_dataset", "description": "Read a portion of a dataset with slicing.\n\nArgs:\n path: Path to dataset within file\n start: Starting indices as comma-separated string (e.g., \"0,0,0\")\n count: Number of elements as comma-separated string (e.g., \"10,10,10\")\n\nReturns:\n Partial dataset description", "function_name": "read_partial_dataset"}, {"name": "get_shape", "description": "Get the shape of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset shape", "function_name": "get_shape"}, {"name": "get_dtype", "description": "Get the data type of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset dtype", "function_name": "get_dtype"}, {"name": "get_size", "description": "Get the size of a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Dataset size", "function_name": "get_size"}, {"name": "get_chunks", "description": "Get chunk information for a dataset.\n\nArgs:\n path: Path to dataset\n\nReturns:\n Chunk configuration", "function_name": "get_chunks"}, {"name": "read_attribute", "description": "Read an attribute from an object.\n\nArgs:\n path: Path to object\n name: Attribute name\n\nReturns:\n Attribute value", "function_name": "read_attribute"}, {"name": "list_attributes", "description": "List all attributes of an object.\n\nArgs:\n path: Path to object\n\nReturns:\n JSON dict of attributes", "function_name": "list_attributes"}, {"name": "hdf5_parallel_scan", "description": "Fast multi-file scanning with parallel processing.\n\nArgs:\n directory: Directory to scan\n pattern: File pattern (default: *.h5)\n ctx: Context for progress reporting\n\nReturns:\n Scan summary with file metadata", "function_name": "hdf5_parallel_scan"}, {"name": "hdf5_batch_read", "description": "Read multiple datasets in parallel.\n\nArgs:\n paths: Comma-separated dataset paths or JSON array\n slice_spec: Optional slice specification\n ctx: Context for progress reporting\n\nReturns:\n Batch read summary", "function_name": "hdf5_batch_read"}, {"name": "hdf5_stream_data", "description": "Stream large datasets efficiently with memory management.\n\nArgs:\n path: Path to dataset\n chunk_size: Number of elements per chunk\n max_chunks: Maximum number of chunks to process\n ctx: Context for progress reporting\n\nReturns:\n Stream processing summary with statistics", "function_name": "hdf5_stream_data"}, {"name": "hdf5_aggregate_stats", "description": "Parallel statistics computation across multiple datasets.\n\nArgs:\n paths: Comma-separated dataset paths or JSON array\n stats: Comma-separated stats to compute (default: mean,std,min,max,sum,count)\n ctx: Context for progress reporting\n\nReturns:\n Aggregate statistics summary", "function_name": "hdf5_aggregate_stats"}, {"name": "analyze_dataset_structure", "description": "Analyze and understand file organization and data patterns with AI insights.\n\nArgs:\n path: Path to analyze (default: root)\n ctx: Context for LLM sampling\n\nReturns:\n Structure analysis with AI insights", "function_name": "analyze_dataset_structure"}, {"name": "find_similar_datasets", "description": "Find datasets with similar characteristics to a reference dataset with AI analysis.\n\nArgs:\n reference_path: Path to reference dataset\n similarity_threshold: Similarity threshold (0.0 to 1.0)\n ctx: Context for LLM sampling\n\nReturns:\n List of similar datasets with similarity scores and AI insights", "function_name": "find_similar_datasets"}, {"name": "suggest_next_exploration", "description": "Suggest interesting data to explore next based on current location with AI recommendations.\n\nArgs:\n current_path: Current path (default: root)\n ctx: Context for LLM sampling\n\nReturns:\n Exploration suggestions with interest scores and AI recommendations", "function_name": "suggest_next_exploration"}, {"name": "identify_io_bottlenecks", "description": "Identify potential I/O bottlenecks and performance issues with AI recommendations.\n\nArgs:\n analysis_paths: Optional list of paths to analyze (auto-discovers if None)\n ctx: Context for LLM sampling\n\nReturns:\n Bottleneck analysis report with AI recommendations", "function_name": "identify_io_bottlenecks"}, {"name": "optimize_access_pattern", "description": "Suggest better approaches for data access based on usage patterns.\n\nArgs:\n dataset_path: Path to dataset\n access_pattern: Access pattern (sequential, random, batch)\n\nReturns:\n Optimization recommendations", "function_name": "optimize_access_pattern"}, {"name": "refresh_hdf5_resources", "description": "Re-scan client roots and update available HDF5 resources.\n\nFastMCP automatically sends notifications/resources/list_changed to clients.\n\nReturns:\n Summary of refreshed resources", "function_name": "refresh_hdf5_resources"}, {"name": "list_available_hdf5_files", "description": "List all registered HDF5 files with resource URIs for Claude Code @ mentions.\n\nReturns:\n List of available files with resource URIs", "function_name": "list_available_hdf5_files"}, {"name": "export_dataset", "description": "Export dataset to various formats with user format selection.\n\nArgs:\n path: Path to dataset within file\n output_path: Optional output file path\n ctx: Context for elicitation\n\nReturns:\n Export summary", "function_name": "export_dataset"}]} > diff --git a/clio-kit-website/docs/mcps/jarvis.md b/clio-kit-website/docs/mcps/jarvis.md index c94be250..dfe81b67 100644 --- a/clio-kit-website/docs/mcps/jarvis.md +++ b/clio-kit-website/docs/mcps/jarvis.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["update_pipeline", "build_pipeline_env", "create_pipeline", "load_pipeline", "get_pkg_config", "append_pkg", "configure_pkg", "unlink_pkg", "remove_pkg", "run_pipeline", "destroy_pipeline", "jm_create_config", "jm_load_config", "jm_save_config", "jm_set_hostfile", "jm_bootstrap_from", "jm_bootstrap_list", "jm_reset", "jm_list_pipelines", "jm_cd", "jm_list_repos", "jm_add_repo", "jm_remove_repo", "jm_promote_repo", "jm_get_repo", "jm_construct_pkg", "jm_graph_show", "jm_graph_build", "jm_graph_modify"]} platforms={["claude", "cursor", "vscode"]} keywords={["jarvis", "pipeline-management", "high-performance-computing", "hpc", "workflow", "data-pipelines", "scientific-computing", "mcp", "package-management"]} - license="MIT" - tools={[{"name": "update_pipeline", "description": "Re-apply environment & configuration to every package in a Jarvis-CD pipeline.", "function_name": "update_pipeline_tool"}, {"name": "build_pipeline_env", "description": "Rebuild a Jarvis-CD pipeline\u2019s env.yaml, capturing only CMAKE_PREFIX_PATH and PATH", "function_name": "build_pipeline_env_tool"}, {"name": "create_pipeline", "description": "Create a new Jarvis-CD pipeline environment.", "function_name": "create_pipeline_tool"}, {"name": "load_pipeline", "description": "Load an existing Jarvis-CD pipeline environment.", "function_name": "load_pipeline_tool"}, {"name": "get_pkg_config", "description": "Retrieve the configuration of a specific package in a Jarvis-CD pipeline.", "function_name": "get_pkg_config_tool"}, {"name": "append_pkg", "description": "Append a package to a Jarvis-CD pipeline.", "function_name": "append_pkg_tool"}, {"name": "configure_pkg", "description": "Configure a package in a Jarvis-CD pipeline.", "function_name": "configure_pkg_tool"}, {"name": "unlink_pkg", "description": "Unlink a package from a Jarvis-CD pipeline (preserve files).", "function_name": "unlink_pkg_tool"}, {"name": "remove_pkg", "description": "Remove a package entirely from a Jarvis-CD pipeline.", "function_name": "remove_pkg_tool"}, {"name": "run_pipeline", "description": "Execute a Jarvis-CD pipeline end-to-end.", "function_name": "run_pipeline_tool"}, {"name": "destroy_pipeline", "description": "Destroy a Jarvis-CD pipeline environment and clean up files.", "function_name": "destroy_pipeline_tool"}, {"name": "jm_create_config", "description": "Initialize JarvisManager config directories.", "function_name": "jm_create_config"}, {"name": "jm_load_config", "description": "Load existing JarvisManager configuration.", "function_name": "jm_load_config"}, {"name": "jm_save_config", "description": "Save current JarvisManager configuration.", "function_name": "jm_save_config"}, {"name": "jm_set_hostfile", "description": "Set hostfile path for JarvisManager.", "function_name": "jm_set_hostfile"}, {"name": "jm_bootstrap_from", "description": "Bootstrap Jarvis config from a machine template.", "function_name": "jm_bootstrap_from"}, {"name": "jm_bootstrap_list", "description": "List available bootstrap machine templates.", "function_name": "jm_bootstrap_list"}, {"name": "jm_reset", "description": "Reset JarvisManager (destroy all pipelines and data).", "function_name": "jm_reset"}, {"name": "jm_list_pipelines", "description": "List all existing Jarvis pipelines.", "function_name": "jm_list_pipelines"}, {"name": "jm_cd", "description": "Change current Jarvis pipeline context.", "function_name": "jm_cd"}, {"name": "jm_list_repos", "description": "List all Jarvis repositories.", "function_name": "jm_list_repos"}, {"name": "jm_add_repo", "description": "Add a repository to JarvisManager.", "function_name": "jm_add_repo"}, {"name": "jm_remove_repo", "description": "Remove a repository from JarvisManager.", "function_name": "jm_remove_repo"}, {"name": "jm_promote_repo", "description": "Promote a repository in JarvisManager.", "function_name": "jm_promote_repo"}, {"name": "jm_get_repo", "description": "Get repository info from JarvisManager.", "function_name": "jm_get_repo"}, {"name": "jm_construct_pkg", "description": "Construct a package skeleton in JarvisManager.", "function_name": "jm_construct_pkg"}, {"name": "jm_graph_show", "description": "Print the current resource graph frames.", "function_name": "jm_graph_show"}, {"name": "jm_graph_build", "description": "Build or rebuild the resource graph with a net sleep interval.", "function_name": "jm_graph_build"}, {"name": "jm_graph_modify", "description": "Modify the resource graph using a net sleep interval.", "function_name": "jm_graph_modify"}]} + license="BSD-3-Clause" + tools={[{"name": "update_pipeline", "description": "Re-apply environment and configuration to every package in a pipeline.", "function_name": "update_pipeline"}, {"name": "build_pipeline_env", "description": "Rebuild a pipeline's env.yaml, capturing CMAKE_PREFIX_PATH and PATH.", "function_name": "build_pipeline_env"}, {"name": "create_pipeline", "description": "Create a new Jarvis-CD pipeline environment.", "function_name": "create_pipeline"}, {"name": "load_pipeline", "description": "Load an existing Jarvis-CD pipeline environment.", "function_name": "load_pipeline"}, {"name": "get_pkg_config", "description": "Retrieve the configuration of a specific package in a pipeline.", "function_name": "get_pkg_config"}, {"name": "append_pkg", "description": "Append a package to a Jarvis-CD pipeline.", "function_name": "append_pkg"}, {"name": "configure_pkg", "description": "Configure a package in a Jarvis-CD pipeline.", "function_name": "configure_pkg"}, {"name": "unlink_pkg", "description": "Unlink a package from a pipeline (preserve files).", "function_name": "unlink_pkg"}, {"name": "remove_pkg", "description": "Remove a package entirely from a pipeline.", "function_name": "remove_pkg"}, {"name": "run_pipeline", "description": "Execute a Jarvis-CD pipeline end-to-end.", "function_name": "run_pipeline"}, {"name": "destroy_pipeline", "description": "Destroy a pipeline environment and clean up files.", "function_name": "destroy_pipeline"}, {"name": "jm_create_config", "description": "Initialize JarvisManager config directories.", "function_name": "jm_create_config"}, {"name": "jm_load_config", "description": "Load existing JarvisManager configuration.", "function_name": "jm_load_config"}, {"name": "jm_save_config", "description": "Save current JarvisManager configuration.", "function_name": "jm_save_config"}, {"name": "jm_set_hostfile", "description": "Set hostfile path for JarvisManager.", "function_name": "jm_set_hostfile"}, {"name": "jm_bootstrap_from", "description": "Bootstrap Jarvis config from a machine template.", "function_name": "jm_bootstrap_from"}, {"name": "jm_bootstrap_list", "description": "List available bootstrap machine templates.", "function_name": "jm_bootstrap_list"}, {"name": "jm_reset", "description": "Reset JarvisManager (destroy all pipelines and data).", "function_name": "jm_reset"}, {"name": "jm_list_pipelines", "description": "List all existing Jarvis pipelines.", "function_name": "jm_list_pipelines"}, {"name": "jm_cd", "description": "Change current Jarvis pipeline context.", "function_name": "jm_cd"}, {"name": "jm_list_repos", "description": "List all Jarvis repositories.", "function_name": "jm_list_repos"}, {"name": "jm_add_repo", "description": "Add a repository to JarvisManager.", "function_name": "jm_add_repo"}, {"name": "jm_remove_repo", "description": "Remove a repository from JarvisManager.", "function_name": "jm_remove_repo"}, {"name": "jm_promote_repo", "description": "Promote a repository in JarvisManager.", "function_name": "jm_promote_repo"}, {"name": "jm_get_repo", "description": "Get repository info from JarvisManager.", "function_name": "jm_get_repo"}, {"name": "jm_construct_pkg", "description": "Construct a package skeleton in JarvisManager.", "function_name": "jm_construct_pkg"}, {"name": "jm_graph_show", "description": "Print the current resource graph frames.", "function_name": "jm_graph_show"}, {"name": "jm_graph_build", "description": "Build or rebuild the resource graph with a net sleep interval.", "function_name": "jm_graph_build"}, {"name": "jm_graph_modify", "description": "Modify the resource graph using a net sleep interval.", "function_name": "jm_graph_modify"}]} > ### 1. Pipeline Creation and Basic Management diff --git a/clio-kit-website/docs/mcps/lmod.md b/clio-kit-website/docs/mcps/lmod.md index 4431665f..55a812ab 100644 --- a/clio-kit-website/docs/mcps/lmod.md +++ b/clio-kit-website/docs/mcps/lmod.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["module_list", "module_avail", "module_show", "module_load", "module_unload", "module_swap", "module_spider", "module_save", "module_restore", "module_savelist"]} platforms={["claude", "cursor", "vscode"]} keywords={["lmod", "environment-modules", "module-management", "hpc", "scientific-computing", "supercomputing", "cluster-computing", "module-system"]} - license="MIT" - tools={[{"name": "module_list", "description": "List all currently loaded environment modules. Shows the active modules in your current shell environment.", "function_name": "module_list_tool"}, {"name": "module_avail", "description": "Search for available modules that can be loaded. Optionally filter by name pattern (e.g., 'python', 'gcc/*', '*mpi*').", "function_name": "module_avail_tool"}, {"name": "module_show", "description": "Display detailed information about a specific module including its description, dependencies, environment variables it sets, and conflicts.", "function_name": "module_show_tool"}, {"name": "module_load", "description": "Load one or more environment modules into the current session. Modules modify environment variables like PATH, LD_LIBRARY_PATH, etc.", "function_name": "module_load_tool"}, {"name": "module_unload", "description": "Unload (remove) one or more currently loaded modules from the environment. Reverses the changes made by module load.", "function_name": "module_unload_tool"}, {"name": "module_swap", "description": "Swap one module for another (unload old_module and load new_module atomically). Useful for switching between different versions.", "function_name": "module_swap_tool"}, {"name": "module_spider", "description": "Search the entire module tree for modules matching a pattern. More comprehensive than module_avail, shows all versions and variants.", "function_name": "module_spider_tool"}, {"name": "module_save", "description": "Save the current set of loaded modules as a named collection for easy restoration later.", "function_name": "module_save_tool"}, {"name": "module_restore", "description": "Restore a previously saved module collection, loading all modules that were saved in that collection.", "function_name": "module_restore_tool"}, {"name": "module_savelist", "description": "List all saved module collections available for restoration.", "function_name": "module_savelist_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "module_list", "description": "List all currently loaded environment modules.", "function_name": "module_list"}, {"name": "module_avail", "description": "Search for available modules, optionally filtered by name pattern.", "function_name": "module_avail"}, {"name": "module_show", "description": "Display detailed information about a specific module.", "function_name": "module_show"}, {"name": "module_load", "description": "Load one or more environment modules into the current session.", "function_name": "module_load"}, {"name": "module_unload", "description": "Unload one or more currently loaded modules from the environment.", "function_name": "module_unload"}, {"name": "module_swap", "description": "Swap one module for another atomically.", "function_name": "module_swap"}, {"name": "module_spider", "description": "Search the entire module tree comprehensively for matching modules.", "function_name": "module_spider"}, {"name": "module_save", "description": "Save currently loaded modules as a named collection.", "function_name": "module_save"}, {"name": "module_restore", "description": "Restore a previously saved module collection.", "function_name": "module_restore"}, {"name": "module_savelist", "description": "List all saved module collections.", "function_name": "module_savelist"}]} > ### 1. HPC Development Environment Setup diff --git a/clio-kit-website/docs/mcps/ndp.md b/clio-kit-website/docs/mcps/ndp.md index 8def2f68..cc7da527 100644 --- a/clio-kit-website/docs/mcps/ndp.md +++ b/clio-kit-website/docs/mcps/ndp.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["list_organizations", "search_datasets", "get_dataset_details"]} platforms={["claude", "cursor", "vscode"]} keywords={["ndp", "dataset-search", "ckan", "mcp", "llm-integration", "scientific-data"]} - license="MIT" - tools={[{"name": "list_organizations", "description": "List organizations available in the National Data Platform. This tool should always be called before searching to verify organization names are correctly formatted. Supports filtering by organization name and selecting different servers (local, global, pre_ckan).", "function_name": "list_organizations"}, {"name": "search_datasets", "description": "Search for datasets in the National Data Platform using simple or advanced search criteria. Supports both term-based searches and field-specific filtering. Use this tool to discover datasets by keywords, organization, format, or other metadata. Results are automatically limited to 20 by default to prevent context overflow - use the limit parameter to adjust this.", "function_name": "search_datasets"}, {"name": "get_dataset_details", "description": "Retrieve detailed information about a specific dataset using its ID or name. Returns comprehensive metadata including all resources, descriptions, and additional fields. Use this after finding datasets with search_datasets to get complete information.", "function_name": "get_dataset_details"}]} + license="BSD-3-Clause" + tools={[{"name": "list_organizations", "description": "List organizations available in the National Data Platform.", "function_name": "list_organizations"}, {"name": "search_datasets", "description": "Search for datasets in the NDP using term-based or field-specific criteria.", "function_name": "search_datasets"}, {"name": "get_dataset_details", "description": "Retrieve detailed metadata for a specific dataset by ID or name.", "function_name": "get_dataset_details"}]} > ### 1. Discover Available Organizations diff --git a/clio-kit-website/docs/mcps/node_hardware.md b/clio-kit-website/docs/mcps/node_hardware.md index 98ae68c5..483db20a 100644 --- a/clio-kit-website/docs/mcps/node_hardware.md +++ b/clio-kit-website/docs/mcps/node_hardware.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["get_cpu_info", "get_memory_info", "get_system_info", "get_disk_info", "get_network_info", "get_gpu_info", "get_sensor_info", "get_process_info", "get_performance_info", "get_remote_node_info", "health_check"]} platforms={["claude", "cursor", "vscode"]} keywords={["hardware-monitoring", "system-analysis", "performance-metrics", "node-information", "ssh-monitoring", "remote-hardware", "mcp", "llm-integration", "infrastructure-monitoring", "distributed-systems"]} - license="MIT" - tools={[{"name": "get_cpu_info", "description": "Get comprehensive CPU information including specifications, core configuration, frequency analysis, and performance metrics.\n\nThis tool provides detailed CPU analysis including:\n- **CPU Model**: Manufacturer, model name, and architecture details\n- **Core Configuration**: Physical and logical core counts with hyperthreading detection\n- **Frequency Analysis**: Current, minimum, and maximum CPU frequencies\n- **Performance Metrics**: Real-time CPU usage across all cores\n- **Cache Information**: L1, L2, and L3 cache sizes and hierarchy\n- **Thermal Status**: CPU temperature monitoring (if available)\n- **Load Analysis**: System load averages and performance indicators\n\n**Use Cases**:\n- Performance monitoring and bottleneck identification\n- System capacity planning and resource allocation\n- CPU-intensive workload analysis\n- Thermal monitoring and cooling assessment\n- Hardware upgrade planning and compatibility checking\n\n**Returns**: Structured CPU information with performance insights and optimization recommendations.", "function_name": "get_cpu_info_tool"}, {"name": "get_memory_info", "description": "Get comprehensive memory information including capacity, usage patterns, and performance characteristics.\n\nThis tool provides detailed memory analysis including:\n- **Memory Capacity**: Total, available, and used memory in bytes and human-readable format\n- **Usage Patterns**: Memory utilization percentages and trends\n- **Swap Configuration**: Swap space allocation, usage, and performance impact\n- **Memory Types**: RAM specifications, speeds, and configurations\n- **Performance Metrics**: Memory bandwidth and latency indicators\n- **Health Indicators**: Memory error detection and health status\n- **Efficiency Analysis**: Memory optimization recommendations\n\n**Use Cases**:\n- Memory usage monitoring and optimization\n- Application memory requirement analysis\n- System performance tuning and bottleneck identification\n- Memory upgrade planning and capacity assessment\n- Memory-intensive workload analysis\n\n**Returns**: Structured memory information with usage insights and optimization recommendations.", "function_name": "get_memory_info_tool"}, {"name": "get_system_info", "description": "Get comprehensive system information including operating system details, platform configuration, and system status.\n\nThis tool provides detailed system analysis including:\n- **Operating System**: OS name, version, distribution, and kernel information\n- **Platform Details**: Architecture, machine type, and processor information\n- **System Status**: Hostname, uptime, boot time, and system load\n- **User Management**: Active users, user sessions, and authentication status\n- **Configuration**: System configuration files and environment variables\n- **Security Status**: Security patches, updates, and vulnerability assessment\n- **Platform Information**: Hardware platform, virtualization status, and cloud environment detection\n\n**Use Cases**:\n- System inventory and asset management\n- OS compatibility checking and upgrade planning\n- Security assessment and patch management\n- System configuration documentation\n- Platform-specific optimization and tuning\n\n**Returns**: Structured system information with configuration insights and security recommendations.", "function_name": "get_system_info_tool"}, {"name": "get_disk_info", "description": "Get comprehensive disk information including storage devices, partitions, and I/O performance metrics.\n\nThis tool provides detailed disk analysis including:\n- **Storage Devices**: Physical disk drives, SSDs, and storage controllers\n- **Partition Information**: File system types, mount points, and partition layouts\n- **Usage Analysis**: Disk space utilization, free space, and growth trends\n- **I/O Performance**: Read/write speeds, IOPS, and latency measurements\n- **Health Monitoring**: SMART status, error rates, and predictive maintenance\n- **File Systems**: File system types, mount options, and performance characteristics\n- **Predictive Maintenance**: Disk health indicators and failure prediction\n\n**Use Cases**:\n- Storage capacity planning and management\n- Disk performance optimization and bottleneck identification\n- Storage upgrade planning and RAID configuration\n- Backup strategy development and storage allocation\n- Disk health monitoring and predictive maintenance\n\n**Returns**: Structured disk information with performance insights and maintenance recommendations.", "function_name": "get_disk_info_tool"}, {"name": "get_network_info", "description": "Get comprehensive network information including interfaces, connections, and bandwidth analysis.\n\nThis tool provides detailed network analysis including:\n- **Network Interfaces**: Physical and virtual network interfaces with status\n- **IP Configuration**: IP addresses, subnet masks, and routing information\n- **Connection Details**: Active connections, protocols, and port usage\n- **Bandwidth Analysis**: Network throughput, packet statistics, and performance metrics\n- **Protocol Statistics**: TCP/UDP statistics, error rates, and connection states\n- **Security Monitoring**: Network security status, firewall rules, and intrusion detection\n- **Performance Optimization**: Network optimization recommendations and bottleneck identification\n\n**Use Cases**:\n- Network performance monitoring and troubleshooting\n- Network capacity planning and bandwidth optimization\n- Network security assessment and monitoring\n- Network configuration documentation and management\n- Network-intensive application analysis\n\n**Returns**: Structured network information with performance insights and security recommendations.", "function_name": "get_network_info_tool"}, {"name": "get_gpu_info", "description": "Get comprehensive GPU information including specifications, memory, and compute capabilities.\n\nThis tool provides detailed GPU analysis including:\n- **GPU Specifications**: GPU model, architecture, and compute capabilities\n- **Memory Analysis**: GPU memory capacity, usage, and bandwidth\n- **Thermal Monitoring**: GPU temperature, fan speeds, and thermal management\n- **Performance Metrics**: GPU utilization, compute performance, and benchmark scores\n- **Driver Information**: GPU driver versions, compatibility, and optimization status\n- **Compute Capabilities**: CUDA, OpenCL, and other compute framework support\n- **Multi-GPU Configuration**: SLI/CrossFire setups and GPU coordination\n\n**Use Cases**:\n- GPU-intensive workload analysis and optimization\n- Machine learning and AI workload planning\n- Gaming performance assessment and optimization\n- GPU upgrade planning and compatibility checking\n- GPU health monitoring and thermal management\n\n**Returns**: Structured GPU information with performance insights and optimization recommendations.", "function_name": "get_gpu_info_tool"}, {"name": "get_sensor_info", "description": "Get sensor information including temperature, fan speeds, and thermal data.\n\nThis tool provides detailed sensor analysis including:\n- **Temperature Sensors**: CPU, GPU, motherboard, and ambient temperature readings\n- **Fan Control**: Fan speeds, RPM monitoring, and cooling system status\n- **Voltage Monitoring**: Power supply voltages, stability, and efficiency metrics\n- **Hardware Health**: Component health indicators and thermal management\n- **Thermal Management**: Cooling system performance and thermal throttling status\n- **Predictive Maintenance**: Temperature trends and failure prediction\n- **Environmental Monitoring**: Ambient conditions and environmental factors\n\n**Use Cases**:\n- Thermal monitoring and cooling system optimization\n- Hardware health monitoring and predictive maintenance\n- Overclocking and performance tuning\n- Environmental monitoring and data center management\n- Thermal throttling analysis and optimization\n\n**Returns**: Structured sensor information with thermal insights and health recommendations.", "function_name": "get_sensor_info_tool"}, {"name": "get_process_info", "description": "Get process information including running processes and resource usage.\n\nThis tool provides detailed process analysis including:\n- **Process List**: All running processes with PIDs and basic information\n- **Resource Consumption**: CPU, memory, and I/O usage per process\n- **Process Hierarchy**: Parent-child relationships and process trees\n- **Performance Metrics**: Process performance indicators and resource utilization\n- **System Load Analysis**: Overall system load and process distribution\n- **Process States**: Running, sleeping, stopped, and zombie processes\n- **Resource Monitoring**: Real-time resource usage tracking and trends\n\n**Use Cases**:\n- Process monitoring and resource optimization\n- Performance troubleshooting and bottleneck identification\n- System load analysis and capacity planning\n- Process management and optimization\n- Resource-intensive application analysis\n\n**Returns**: Structured process information with resource insights and optimization recommendations.", "function_name": "get_process_info_tool"}, {"name": "get_performance_info", "description": "Get real-time performance metrics including CPU, memory, and disk usage.\n\nThis tool provides comprehensive performance analysis including:\n- **CPU Performance**: Real-time CPU usage, load averages, and performance metrics\n- **Memory Performance**: Memory usage, swap activity, and memory pressure indicators\n- **Disk Performance**: Disk I/O rates, latency, and throughput measurements\n- **Network Performance**: Network throughput, packet rates, and connection statistics\n- **System Load**: Overall system load and performance indicators\n- **Bottleneck Analysis**: Performance bottleneck identification and analysis\n- **Optimization Recommendations**: Performance optimization suggestions and tuning advice\n\n**Use Cases**:\n- Real-time performance monitoring and alerting\n- Performance bottleneck identification and resolution\n- System optimization and tuning\n- Capacity planning and resource allocation\n- Performance benchmarking and comparison\n\n**Returns**: Structured performance information with bottleneck analysis and optimization recommendations.", "function_name": "get_performance_info_tool"}, {"name": "get_remote_node_info", "description": "Get comprehensive remote node hardware and system information via SSH with advanced filtering and intelligent analysis.\n\nThis powerful tool provides complete remote system analysis by securely connecting to remote nodes via SSH \nand collecting information from all hardware and system components with sophisticated filtering capabilities. \nIt delivers comprehensive specifications with intelligent data organization, performance analysis, and optimization recommendations.\n\n**Remote Hardware Collection Strategy**:\n1. **Secure SSH Connection**: Establishes secure SSH connection with comprehensive authentication support and connection optimization\n2. **Remote Discovery**: Automatically detects and analyzes all available remote hardware components\n3. **Intelligent Filtering**: Applies sophisticated filtering to focus on specific components or exclude unwanted data\n4. **Cross-Component Analysis**: Provides integrated analysis across all remote system subsystems for holistic insights\n5. **Network Optimization**: Optimized data collection to minimize network bandwidth usage and connection overhead\n\n**Available Remote Hardware Components**:\n- **cpu**: Remote CPU specifications, core configuration, frequency analysis, cache hierarchy, performance metrics, thermal status\n- **memory**: Remote memory capacity, usage patterns, swap configuration, performance characteristics, health indicators, efficiency analysis\n- **disk**: Remote storage devices, usage analysis, I/O performance, health monitoring, file systems, predictive maintenance\n- **network**: Remote network interfaces, bandwidth analysis, connection details, protocol statistics, security monitoring, performance optimization\n- **system**: Remote operating system details, uptime analysis, user management, configuration, platform information, security status\n- **processes**: Remote running processes, resource consumption, process hierarchy, performance metrics, system load analysis\n- **gpu**: Remote GPU specifications, memory analysis, thermal monitoring, performance metrics, driver information, compute capabilities\n- **sensors**: Remote temperature sensors, fan control, voltage monitoring, hardware health, thermal management, predictive maintenance\n- **performance**: Remote real-time performance monitoring, bottleneck analysis, optimization recommendations, trend analysis\n- **summary**: Remote integrated hardware overview with cross-subsystem analysis and comprehensive health assessment\n\n**SSH Connection and Authentication**:\n- **SSH Key Authentication**: Secure key-based authentication with support for various key types (RSA, Ed25519, ECDSA)\n- **Password Authentication**: Fallback password authentication with secure handling\n- **Connection Management**: Configurable connection parameters including port, timeout, user, and advanced SSH options\n- **Security Best Practices**: Implements SSH security best practices with connection validation and error handling\n- **Multi-Platform Support**: Compatible with various remote system configurations and platform variations\n\n**Advanced Remote Filtering Capabilities**:\n- **Include Filters**: Specify exactly which components to collect for focused analysis and reduced network overhead\n- **Exclude Filters**: Remove specific components from collection for streamlined results and improved performance\n- **Component Selection**: Choose from comprehensive list of hardware and system components with intelligent organization\n- **Network Efficiency**: Optimized data collection to minimize network bandwidth usage and connection overhead\n- **Metadata Tracking**: Track collection process, success rates, error handling, and SSH connection performance metrics\n\n**Remote Performance Analysis Features**:\n- **Remote Bottleneck Detection**: Automated identification of performance bottlenecks on remote systems with resolution strategies\n- **Distributed Resource Optimization**: Analysis of resource utilization patterns across remote systems with efficiency improvement recommendations\n- **Remote Predictive Maintenance**: Sensor-based predictive maintenance and failure prediction with trend analysis for remote systems\n- **Distributed Capacity Planning**: Growth trend analysis with capacity recommendations and scaling strategies for remote infrastructure\n- **Remote Health Assessment**: Comprehensive health monitoring with trend analysis and predictive insights for distributed systems\n\n**Intelligence and Remote Insights**:\n- **Distributed Analysis**: AI-powered analysis of remote hardware configurations and performance patterns\n- **Remote Optimization**: Intelligent recommendations for remote system optimization and performance improvement\n- **Cross-System Trend Analysis**: Historical trend analysis and predictive insights for distributed capacity planning\n- **Remote Anomaly Detection**: Automated detection of unusual patterns and potential issues across remote systems\n- **Distributed Best Practices**: Industry best practices and configuration recommendations for remote infrastructure\n\n**Prerequisites**: SSH access to remote systems with hardware information retrieval capabilities\n**Tools to use before this**: health_check() to verify local system capabilities, get_node_info() for local baseline comparison\n**Tools to use after this**: Additional remote analysis tools or optimization tools based on remote system results\n\nUse this tool when:\n- Getting complete remote system overview with selective focus (\"Show me remote CPU and memory info with performance analysis\")\n- Collecting comprehensive remote hardware information for distributed analysis, reporting, or infrastructure documentation\n- Performing remote system audits with customizable scope, depth, and intelligent analysis across distributed infrastructure\n- Monitoring remote system health and performance characteristics with predictive maintenance insights for distributed systems\n- Planning remote system upgrades and capacity requirements with trend analysis and recommendations for distributed infrastructure\n- Troubleshooting remote hardware and performance issues with intelligent diagnostic capabilities across distributed systems\n- Conducting distributed infrastructure assessments with comprehensive analysis and optimization guidance for remote systems", "function_name": "get_remote_node_info_tool"}, {"name": "health_check", "description": "Perform comprehensive health check and system diagnostics with advanced capability verification.\n\nThis tool provides complete system health assessment by verifying all hardware monitoring \ncapabilities, system compatibility, and performance characteristics. It delivers comprehensive \nhealth status with diagnostic insights, optimization recommendations, and predictive maintenance guidance.\n\n**Health Assessment Strategy**:\n1. **Comprehensive Verification**: Systematically verifies all hardware monitoring capabilities and system compatibility\n2. **Performance Diagnostics**: Performs comprehensive system diagnostics and performance assessment with benchmarking\n3. **Capability Analysis**: Provides detailed capability status and functionality verification with compatibility testing\n4. **Health Metrics**: Delivers system health metrics and optimization recommendations with trend analysis\n5. **Predictive Insights**: Generates comprehensive diagnostic report with actionable insights and predictive maintenance guidance\n\n**Health Check Components**:\n- **Server Status**: Overall MCP server health and functionality verification with performance metrics\n- **Capability Verification**: Individual tool functionality and system compatibility testing with detailed reporting\n- **System Compatibility**: Platform compatibility and dependency verification with requirement analysis\n- **Performance Assessment**: Server performance metrics and response time analysis with optimization recommendations\n- **Diagnostic Insights**: System diagnostic information and health indicators with trend analysis\n- **Optimization Recommendations**: System optimization suggestions and improvement strategies with implementation guidance\n- **Predictive Maintenance**: Predictive maintenance insights and failure prediction with preventive recommendations\n\n**Advanced Diagnostic Features**:\n- **Comprehensive Testing**: Multi-layered capability testing with detailed error reporting and resolution guidance\n- **Platform Analysis**: System compatibility analysis with platform-specific recommendations and optimization strategies\n- **Performance Benchmarking**: Performance benchmarking and optimization insights with comparative analysis\n- **Trend Analysis**: Health trend analysis and predictive maintenance suggestions with historical data integration\n- **Troubleshooting Integration**: Diagnostic troubleshooting and problem resolution guidance with step-by-step instructions\n- **Security Assessment**: Security posture analysis and vulnerability assessment with remediation recommendations\n\n**Intelligence and Automation**:\n- **Automated Diagnostics**: AI-powered diagnostic analysis with intelligent problem identification\n- **Predictive Analytics**: Predictive maintenance recommendations based on system health trends\n- **Optimization Intelligence**: Intelligent optimization recommendations with performance impact analysis\n- **Proactive Monitoring**: Proactive health monitoring with early warning systems and alerting\n- **Best Practice Integration**: Industry best practices integration with compliance checking\n\n**Prerequisites**: No special requirements - designed for comprehensive system assessment and compatibility verification\n**Tools to use before this**: None - this is typically the first tool to run for system verification\n**Tools to use after this**: get_node_info() and get_remote_node_info() based on health check results and recommendations for detailed analysis\n\nUse this tool when:\n- Verifying system health and MCP server functionality (\"Check system health and capabilities\")\n- Diagnosing system issues and compatibility problems with comprehensive analysis\n- Assessing system performance and optimization opportunities with benchmarking\n- Validating system capabilities and functionality before production deployment\n- Troubleshooting system problems and performance issues with intelligent diagnostics\n- Conducting system audits and compliance checking with best practice validation\n- Planning system maintenance and optimization with predictive insights\n- Establishing baseline health metrics for ongoing monitoring and trend analysis", "function_name": "health_check_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "get_cpu_info", "description": "Get CPU specifications, core counts, frequencies, and per-core usage.", "function_name": "get_cpu_info"}, {"name": "get_memory_info", "description": "Get RAM and swap capacity, usage percentages, and availability.", "function_name": "get_memory_info"}, {"name": "get_system_info", "description": "Get OS details, hostname, uptime, and active users.", "function_name": "get_system_info"}, {"name": "get_disk_info", "description": "Get disk partitions, usage statistics, and I/O counters.", "function_name": "get_disk_info"}, {"name": "get_network_info", "description": "Get network interfaces, IP addresses, and I/O statistics.", "function_name": "get_network_info"}, {"name": "get_gpu_info", "description": "Get GPU model, memory, temperature, and utilization via nvidia-smi/rocm-smi.", "function_name": "get_gpu_info"}, {"name": "get_sensor_info", "description": "Get temperature, fan speed, and battery sensor readings.", "function_name": "get_sensor_info"}, {"name": "get_process_info", "description": "Get running processes with CPU, memory, and status details.", "function_name": "get_process_info"}, {"name": "get_performance_info", "description": "Get real-time CPU, memory, disk, and network performance metrics.", "function_name": "get_performance_info"}, {"name": "get_remote_node_info", "description": "Collect hardware info from a remote node via SSH. Supports component filtering.", "function_name": "get_remote_node_info"}, {"name": "health_check", "description": "Verify server health and hardware monitoring capability status.", "function_name": "health_check"}]} > ### 1. Local Hardware Overview diff --git a/clio-kit-website/docs/mcps/pandas.md b/clio-kit-website/docs/mcps/pandas.md index 33994cd6..bc4df0b4 100644 --- a/clio-kit-website/docs/mcps/pandas.md +++ b/clio-kit-website/docs/mcps/pandas.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["load_data", "save_data", "statistical_summary", "correlation_analysis", "hypothesis_testing", "handle_missing_data", "clean_data", "groupby_operations", "merge_datasets", "pivot_table", "time_series_operations", "validate_data", "filter_data", "optimize_memory", "profile_data"]} platforms={["claude", "cursor", "vscode"]} keywords={["pandas", "data-analysis", "statistical-analysis", "data-science", "data-manipulation", "time-series", "data-cleaning", "data-transformation", "mcp", "llm-integration"]} - license="MIT" - tools={[{"name": "load_data", "description": "Load and parse data from multiple file formats with advanced options for data ingestion. \n\nThis comprehensive tool supports CSV, Excel, JSON, Parquet, and HDF5 formats with intelligent \nparsing capabilities. It provides customizable encoding detection, selective column loading, \nand efficient data processing for optimal performance.\n\n**Smart Loading Strategy**:\n1. Automatically detects file format from extension\n2. Performs encoding detection for text files\n3. Provides memory-efficient loading with chunking support\n4. Validates data integrity during loading\n5. Generates comprehensive metadata and quality reports\n\n**Supported Formats**:\n- **CSV**: Comma-separated values with customizable delimiters\n- **Excel**: .xlsx and .xls files with multi-sheet support\n- **JSON**: Structured JSON data with nested object handling\n- **Parquet**: High-performance columnar format\n- **HDF5**: Hierarchical data format for large datasets\n\n**Performance Optimization**:\n- Selective column loading to reduce memory usage\n- Row limiting for large dataset sampling\n- Automatic data type inference and optimization\n- Memory usage reporting and recommendations\n\n**Prerequisites**: File must exist and be readable\n**Tools to use after this**: profile_data() for initial analysis, clean_data() for quality improvement\n\nUse this tool when:\n- Starting data analysis workflows (\"Load my dataset\")\n- Exploring new datasets for the first time\n- Converting between different data formats\n- Sampling large datasets for initial analysis\n- Validating data structure and quality", "function_name": "load_data_tool"}, {"name": "save_data", "description": "Save processed data to multiple file formats with optimization options for storage efficiency.\n\nThis tool provides comprehensive data export capabilities with format-specific optimizations,\ncompression options, and data integrity validation. It supports all major data formats\nwith intelligent format selection and performance tuning.\n\n**Export Strategy**:\n1. Automatically selects optimal format based on data characteristics\n2. Applies compression for space efficiency\n3. Validates data integrity before and after export\n4. Provides detailed export statistics and recommendations\n5. Supports incremental updates for large datasets\n\n**Format Optimization**:\n- **CSV**: Configurable separators and encoding options\n- **Excel**: Multi-sheet support with formatting preservation\n- **JSON**: Nested structure handling with compression\n- **Parquet**: Columnar compression for analytics workloads\n- **HDF5**: Hierarchical storage for complex data structures\n\n**Performance Features**:\n- Automatic compression selection based on data type\n- Memory-efficient writing for large datasets\n- Progress tracking for long-running operations\n- Storage space optimization recommendations\n\n**Prerequisites**: Data must be in valid format\n**Tools to use before this**: clean_data() for quality assurance, optimize_memory() for large datasets\n\nUse this tool when:\n- Exporting processed data for sharing or archival\n- Converting between different data formats\n- Creating compressed versions of large datasets\n- Saving intermediate results in analysis workflows\n- Preparing data for external systems or applications", "function_name": "save_data_tool"}, {"name": "statistical_summary", "description": "Generate comprehensive statistical summaries with descriptive statistics, distribution analysis, and data profiling.\n\nThis tool provides detailed insights into data characteristics including central tendencies,\nvariability, and distribution shapes. It goes beyond basic statistics to provide actionable\ninsights for data analysis and decision-making.\n\n**Analysis Strategy**:\n1. Computes comprehensive descriptive statistics\n2. Analyzes data distributions and normality\n3. Identifies outliers and anomalies\n4. Provides data quality assessments\n5. Generates actionable insights and recommendations\n\n**Statistical Measures**:\n- **Central Tendency**: Mean, median, mode with confidence intervals\n- **Variability**: Standard deviation, variance, range, IQR\n- **Distribution**: Skewness, kurtosis, normality tests\n- **Outlier Detection**: Z-score, IQR-based, and statistical methods\n- **Data Quality**: Missing values, duplicates, consistency checks\n\n**Advanced Features**:\n- Distribution fitting and goodness-of-fit tests\n- Correlation analysis between variables\n- Seasonal pattern detection for time series\n- Categorical variable analysis and frequency distributions\n- Statistical significance testing for group comparisons\n\n**Prerequisites**: Data must be loaded and accessible\n**Tools to use after this**: correlation_analysis() for relationships, hypothesis_testing() for inference\n\nUse this tool when:\n- Exploring new datasets for the first time\n- Understanding data characteristics and quality\n- Identifying patterns and anomalies in data\n- Preparing data for modeling or analysis\n- Generating reports for stakeholders", "function_name": "statistical_summary_tool"}, {"name": "correlation_analysis", "description": "Perform comprehensive correlation analysis with multiple correlation methods and significance testing.\n\nThis tool provides detailed insights into variable relationships, dependency patterns, and \nstatistical significance of correlations. It supports multiple correlation methods and \nprovides actionable insights for feature selection and data understanding.\n\n**Correlation Methods**:\n- **Pearson**: Linear relationships between continuous variables\n- **Spearman**: Monotonic relationships and ordinal data\n- **Kendall**: Rank-based correlation for non-parametric data\n\n**Analysis Features**:\n1. Computes correlation matrices with significance testing\n2. Identifies strong positive and negative correlations\n3. Provides p-values and confidence intervals\n4. Detects multicollinearity issues\n5. Generates correlation insights and recommendations\n\n**Advanced Capabilities**:\n- Partial correlation analysis controlling for confounding variables\n- Time-lagged correlation for temporal data\n- Categorical variable association measures\n- Correlation stability analysis across data subsets\n- Feature importance ranking based on correlations\n\n**Visualization Support**:\n- Correlation heatmap data preparation\n- Network graph data for correlation relationships\n- Scatter plot recommendations for strong correlations\n- Hierarchical clustering of correlated variables\n\n**Prerequisites**: Data must contain numerical variables\n**Tools to use before this**: statistical_summary() for data overview\n**Tools to use after this**: hypothesis_testing() for statistical inference\n\nUse this tool when:\n- Exploring relationships between variables\n- Feature selection for machine learning\n- Identifying redundant or highly correlated features\n- Understanding data structure and dependencies\n- Detecting multicollinearity in regression analysis", "function_name": "correlation_analysis_tool"}, {"name": "hypothesis_testing", "description": "Perform comprehensive statistical hypothesis testing with multiple test types and advanced analysis.\n\nThis tool supports a wide range of statistical tests including t-tests, chi-square tests, \nANOVA, and normality tests. It provides statistical inference with confidence intervals,\np-values, and effect size calculations for robust decision-making.\n\n**Supported Test Types**:\n- **t_test**: One-sample, two-sample, and paired t-tests\n- **chi_square**: Independence tests for categorical variables\n- **anova**: One-way and two-way analysis of variance\n- **normality**: Shapiro-Wilk, Kolmogorov-Smirnov tests\n- **mann_whitney**: Non-parametric alternative to t-test\n\n**Statistical Inference**:\n1. Computes test statistics and p-values\n2. Provides confidence intervals for parameters\n3. Calculates effect sizes (Cohen's d, eta-squared)\n4. Performs power analysis and sample size recommendations\n5. Generates statistical interpretation and conclusions\n\n**Advanced Features**:\n- Multiple comparison corrections (Bonferroni, FDR)\n- Assumption checking and validation\n- Bootstrap confidence intervals\n- Bayesian hypothesis testing alternatives\n- Practical significance assessment\n\n**Result Interpretation**:\n- Statistical significance vs practical significance\n- Effect size interpretation guidelines\n- Power analysis and sample size adequacy\n- Assumption violation warnings and alternatives\n- Actionable conclusions and recommendations\n\n**Prerequisites**: Data must be appropriate for the chosen test\n**Tools to use before this**: statistical_summary() for data exploration\n**Tools to use after this**: Additional analysis based on test results\n\nUse this tool when:\n- Testing specific hypotheses about your data\n- Comparing groups or treatments\n- Validating assumptions for modeling\n- Making statistical inferences and decisions\n- Preparing results for publication or reporting", "function_name": "hypothesis_testing_tool"}, {"name": "handle_missing_data", "description": "Comprehensive missing data handling with multiple strategies for detection, imputation, and removal.\n\nThis tool provides sophisticated approaches to data completeness including statistical \nimputation methods, missing data pattern analysis, and intelligent handling strategies\nbased on data characteristics and analysis requirements.\n\n**Missing Data Strategies**:\n- **detect**: Comprehensive missing data analysis and pattern identification\n- **impute**: Statistical imputation using various methods\n- **remove**: Intelligent removal of missing data with impact analysis\n- **analyze**: Deep analysis of missing data patterns and mechanisms\n\n**Imputation Methods**:\n- **mean/median/mode**: Central tendency imputation for numerical/categorical data\n- **forward_fill/backward_fill**: Temporal imputation for time series\n- **interpolate**: Mathematical interpolation for smooth data\n- **regression**: Predictive imputation using other variables\n- **knn**: K-nearest neighbors imputation\n\n**Pattern Analysis**:\n1. Identifies missing data patterns (MCAR, MAR, MNAR)\n2. Analyzes correlation between missingness and other variables\n3. Provides recommendations for optimal handling strategies\n4. Assesses impact of different imputation methods\n5. Validates imputation quality and bias assessment\n\n**Quality Assurance**:\n- Before/after comparison of data completeness\n- Imputation quality metrics and validation\n- Bias assessment and correction recommendations\n- Impact analysis on downstream analysis\n- Alternative strategy suggestions\n\n**Prerequisites**: Data must be loaded and accessible\n**Tools to use after this**: clean_data() for additional quality improvements, validate_data() for verification\n\nUse this tool when:\n- Dealing with incomplete datasets\n- Preparing data for analysis or modeling\n- Understanding missing data patterns and mechanisms\n- Choosing optimal imputation strategies\n- Validating data completeness requirements", "function_name": "handle_missing_data_tool"}, {"name": "clean_data", "description": "Comprehensive data cleaning with advanced outlier detection, duplicate removal, and intelligent type conversion.\n\nThis tool provides sophisticated data quality improvement with statistical validation\nand automated data standardization. It combines multiple cleaning techniques to ensure\ndata integrity and consistency for downstream analysis.\n\n**Cleaning Operations**:\n- **Duplicate Detection**: Intelligent duplicate identification and removal\n- **Outlier Detection**: Statistical outlier identification using IQR and Z-score methods\n- **Type Conversion**: Automatic data type optimization and correction\n- **Standardization**: Data format standardization and normalization\n- **Validation**: Data integrity checks and quality assurance\n\n**Outlier Detection Methods**:\n- **IQR Method**: Interquartile range-based outlier detection\n- **Z-Score**: Standard deviation-based outlier identification\n- **Isolation Forest**: Machine learning-based anomaly detection\n- **Local Outlier Factor**: Density-based outlier detection\n- **Statistical Tests**: Grubbs test and other statistical methods\n\n**Quality Improvements**:\n1. Removes exact and near-duplicate records\n2. Standardizes data formats and representations\n3. Corrects data type inconsistencies\n4. Validates data integrity and consistency\n5. Provides detailed cleaning reports and recommendations\n\n**Performance Optimization**:\n- Memory-efficient processing for large datasets\n- Parallel processing for computationally intensive operations\n- Progress tracking for long-running cleaning operations\n- Optimization recommendations for future data processing\n\n**Prerequisites**: Data must be loaded and accessible\n**Tools to use before this**: handle_missing_data() for completeness\n**Tools to use after this**: validate_data() for quality verification\n\nUse this tool when:\n- Preparing data for analysis or modeling\n- Improving data quality and consistency\n- Removing noise and anomalies from datasets\n- Standardizing data formats and types\n- Ensuring data integrity before processing", "function_name": "clean_data_tool"}, {"name": "groupby_operations", "description": "Perform sophisticated groupby operations with aggregations, transformations, and filtering.\n\nThis tool provides comprehensive data grouping capabilities with multiple aggregation\nfunctions and advanced analytical operations. It enables complex data summarization\nand analysis patterns commonly used in business intelligence and data analysis.\n\n**Grouping Strategy**:\n1. Groups data by specified columns with intelligent handling\n2. Applies multiple aggregation functions simultaneously\n3. Supports custom aggregation logic and calculations\n4. Provides group-level statistics and insights\n5. Enables hierarchical grouping and multi-level analysis\n\n**Aggregation Functions**:\n- **sum**: Total values within groups\n- **mean**: Average values with confidence intervals\n- **count**: Record counts and frequency analysis\n- **min/max**: Extreme values and range analysis\n- **std/var**: Variability measures within groups\n- **median**: Robust central tendency measures\n- **custom**: User-defined aggregation functions\n\n**Advanced Features**:\n- Multi-level grouping with hierarchical analysis\n- Conditional aggregation based on filters\n- Group-wise transformations and calculations\n- Statistical significance testing between groups\n- Performance optimization for large datasets\n\n**Filtering Integration**:\n- Pre-grouping filters for data subset analysis\n- Post-aggregation filters for result refinement\n- Dynamic filtering based on group characteristics\n- Conditional logic for complex business rules\n\n**Prerequisites**: Data must be loaded with grouping columns present\n**Tools to use after this**: statistical_summary() for group analysis, pivot_table() for cross-tabulation\n\nUse this tool when:\n- Summarizing data by categories or segments\n- Calculating group-wise statistics and metrics\n- Analyzing patterns across different data segments\n- Creating aggregated reports and dashboards\n- Performing business intelligence analysis", "function_name": "groupby_operations_tool"}, {"name": "merge_datasets", "description": "Merge and join datasets with sophisticated join operations and relationship analysis.\n\nThis tool supports all SQL-style joins (inner, outer, left, right) with comprehensive\ndata integration capabilities and merge conflict resolution. It provides intelligent\nhandling of data relationships and quality assessment of merged results.\n\n**Join Types**:\n- **inner**: Only matching records from both datasets\n- **outer**: All records from both datasets with null filling\n- **left**: All records from left dataset with matching from right\n- **right**: All records from right dataset with matching from left\n\n**Merge Strategy**:\n1. Analyzes data relationships and key distributions\n2. Validates merge keys and identifies potential issues\n3. Performs intelligent duplicate handling\n4. Provides merge statistics and quality assessment\n5. Offers optimization suggestions for large datasets\n\n**Quality Assurance**:\n- Pre-merge validation of key columns\n- Duplicate detection and handling strategies\n- Data type compatibility checking\n- Merge result validation and quality metrics\n- Performance optimization for large datasets\n\n**Relationship Analysis**:\n- One-to-one, one-to-many, many-to-many detection\n- Key distribution analysis and cardinality assessment\n- Merge effectiveness evaluation\n- Data overlap and coverage analysis\n- Referential integrity validation\n\n**Advanced Features**:\n- Fuzzy matching for approximate joins\n- Multi-column merge key support\n- Custom merge logic and transformations\n- Incremental merge support for large datasets\n- Conflict resolution strategies\n\n**Prerequisites**: Both datasets must be accessible and contain merge keys\n**Tools to use before this**: profile_data() for key analysis\n**Tools to use after this**: validate_data() for merge quality assessment\n\nUse this tool when:\n- Combining data from multiple sources\n- Enriching datasets with additional information\n- Creating comprehensive analytical datasets\n- Integrating related data tables\n- Performing data warehouse-style operations", "function_name": "merge_datasets_tool"}, {"name": "pivot_table", "description": "Create sophisticated pivot tables and cross-tabulations with advanced aggregation capabilities.\n\nThis tool provides comprehensive data summarization with multiple aggregation functions\nand hierarchical data organization. It enables complex data reshaping and analysis\npatterns commonly used in business reporting and data exploration.\n\n**Pivot Strategy**:\n1. Reshapes data from long to wide format\n2. Creates cross-tabulations with multiple dimensions\n3. Applies aggregation functions to summarize data\n4. Handles missing values and edge cases intelligently\n5. Provides hierarchical indexing for complex analysis\n\n**Aggregation Functions**:\n- **mean**: Average values with statistical significance\n- **sum**: Total values with subtotals and grand totals\n- **count**: Frequency analysis and contingency tables\n- **min/max**: Extreme value analysis\n- **std/var**: Variability measures across dimensions\n- **median**: Robust central tendency measures\n- **custom**: User-defined aggregation logic\n\n**Advanced Features**:\n- Multi-level row and column indexing\n- Percentage calculations and ratios\n- Marginal totals and subtotals\n- Missing value handling strategies\n- Performance optimization for large datasets\n\n**Cross-Tabulation Analysis**:\n- Contingency table creation and analysis\n- Chi-square tests for independence\n- Percentage breakdowns by row/column/total\n- Statistical significance testing\n- Association strength measures\n\n**Visualization Support**:\n- Data formatting for heatmaps and charts\n- Hierarchical data structure for tree maps\n- Time series pivot for trend analysis\n- Categorical analysis for bar charts\n\n**Prerequisites**: Data must contain categorical columns for pivoting\n**Tools to use before this**: groupby_operations() for preliminary analysis\n**Tools to use after this**: statistical_summary() for pivot result analysis\n\nUse this tool when:\n- Creating summary reports and dashboards\n- Analyzing data across multiple dimensions\n- Performing cross-tabulation analysis\n- Reshaping data for visualization\n- Creating business intelligence reports", "function_name": "pivot_table_tool"}, {"name": "time_series_operations", "description": "Perform comprehensive time series operations with advanced temporal analysis capabilities.\n\nThis tool supports resampling, rolling windows, lag features, trend analysis, and\nseasonality detection for temporal data insights. It provides sophisticated time\nseries analysis capabilities for forecasting and pattern recognition.\n\n**Time Series Operations**:\n- **resample**: Aggregate data at different time frequencies\n- **rolling_mean**: Moving averages with customizable windows\n- **lag**: Create lagged features for predictive modeling\n- **trend**: Trend analysis and decomposition\n- **seasonality**: Seasonal pattern detection and analysis\n\n**Temporal Analysis**:\n1. Automatic datetime parsing and validation\n2. Time series decomposition (trend, seasonal, residual)\n3. Stationarity testing and transformation\n4. Autocorrelation and partial autocorrelation analysis\n5. Seasonal pattern identification and quantification\n\n**Resampling Capabilities**:\n- **D**: Daily aggregation with business day handling\n- **W**: Weekly aggregation with customizable week start\n- **M**: Monthly aggregation with period-end alignment\n- **Q**: Quarterly analysis for business reporting\n- **Y**: Annual aggregation for long-term trends\n\n**Advanced Features**:\n- Missing timestamp handling and interpolation\n- Irregular time series processing\n- Multi-variate time series analysis\n- Change point detection\n- Anomaly detection in temporal data\n\n**Forecasting Support**:\n- Trend extrapolation and projection\n- Seasonal adjustment and normalization\n- Feature engineering for time series modeling\n- Cross-validation for temporal data\n- Performance metrics for forecasting accuracy\n\n**Prerequisites**: Data must contain datetime column\n**Tools to use before this**: load_data() with proper datetime parsing\n**Tools to use after this**: statistical_summary() for temporal pattern analysis\n\nUse this tool when:\n- Analyzing temporal patterns and trends\n- Preparing data for forecasting models\n- Detecting seasonal patterns and cycles\n- Creating time-based features for modeling\n- Performing time series decomposition and analysis", "function_name": "time_series_operations_tool"}, {"name": "validate_data", "description": "Comprehensive data validation with advanced constraint checking and quality assessment.\n\nThis tool performs range validation, consistency checks, business rule validation,\nand data integrity verification with detailed validation reports and error identification.\nIt ensures data quality and compliance with specified requirements.\n\n**Validation Types**:\n- **Range Validation**: Min/max value constraints for numerical data\n- **Type Validation**: Data type consistency and format checking\n- **Pattern Validation**: Regex pattern matching for structured data\n- **Uniqueness Validation**: Duplicate detection and uniqueness constraints\n- **Completeness Validation**: Missing value detection and null constraints\n- **Referential Integrity**: Foreign key and relationship validation\n\n**Business Rule Validation**:\n1. Custom validation rules and logic\n2. Cross-field validation and dependencies\n3. Conditional validation based on data context\n4. Industry-specific validation patterns\n5. Compliance checking for regulatory requirements\n\n**Quality Assessment**:\n- Data quality scoring and metrics\n- Validation violation severity assessment\n- Impact analysis of data quality issues\n- Recommendations for quality improvement\n- Trend analysis of data quality over time\n\n**Validation Rules Structure**:\n```\n{\n \"column_name\": {\n \"min\": minimum_value,\n \"max\": maximum_value,\n \"type\": expected_data_type,\n \"regex\": pattern_string,\n \"not_null\": boolean,\n \"unique\": boolean,\n \"in_list\": [allowed_values]\n }\n}\n```\n\n**Error Reporting**:\n- Detailed violation reports with row-level errors\n- Statistical summary of validation results\n- Severity classification and prioritization\n- Actionable recommendations for error resolution\n- Export capabilities for validation reports\n\n**Prerequisites**: Data must be loaded and validation rules defined\n**Tools to use before this**: clean_data() for basic quality improvement\n**Tools to use after this**: Additional cleaning based on validation results\n\nUse this tool when:\n- Ensuring data quality and integrity\n- Validating data against business rules\n- Preparing data for critical applications\n- Monitoring data quality over time\n- Compliance checking and auditing", "function_name": "validate_data_tool"}, {"name": "filter_data", "description": "Advanced data filtering with sophisticated boolean indexing and conditional expressions.\n\nThis tool supports complex multi-condition filtering, logical operations, range-based\nfiltering, and pattern matching with flexible query syntax for precise data selection.\nIt provides powerful data subsetting capabilities for analysis and reporting.\n\n**Filtering Capabilities**:\n- **Comparison Operators**: eq, ne, gt, lt, ge, le for numerical comparisons\n- **Membership Operators**: in, not_in for categorical filtering\n- **Pattern Matching**: contains, regex for text-based filtering\n- **Logical Operators**: AND, OR, NOT for complex conditions\n- **Range Filtering**: Between, outside range for numerical data\n- **Null Filtering**: is_null, not_null for missing value handling\n\n**Advanced Features**:\n1. Multi-condition filtering with logical operators\n2. Dynamic filtering based on statistical thresholds\n3. Percentile-based filtering for outlier removal\n4. Time-based filtering for temporal data\n5. Categorical filtering with fuzzy matching\n\n**Filter Condition Structure**:\n```\n{\n \"column_name\": {\n \"operator\": \"value\"\n }\n}\n# or simple format:\n{\n \"column_name\": \"value\" # defaults to equality\n}\n```\n\n**Performance Optimization**:\n- Efficient indexing for large datasets\n- Query optimization and execution planning\n- Memory-efficient filtering for large files\n- Parallel processing for complex filters\n- Progress tracking for long-running operations\n\n**Quality Assurance**:\n- Filter validation and syntax checking\n- Result set statistics and summaries\n- Data quality assessment of filtered results\n- Performance metrics and optimization suggestions\n- Export capabilities for filtered datasets\n\n**Prerequisites**: Data must be loaded and accessible\n**Tools to use before this**: profile_data() for filter planning\n**Tools to use after this**: statistical_summary() for filtered data analysis\n\nUse this tool when:\n- Selecting specific data subsets for analysis\n- Removing outliers and anomalies\n- Creating focused datasets for reporting\n- Implementing business logic and rules\n- Preparing data for specific analytical tasks", "function_name": "filter_data_tool"}, {"name": "optimize_memory", "description": "Advanced memory optimization for large datasets with intelligent type conversion and chunking strategies.\n\nThis tool provides automatic dtype optimization, memory usage analysis, sparse data\nhandling, and efficient memory allocation for optimal performance with large datasets.\nIt enables processing of datasets that exceed available memory.\n\n**Optimization Strategies**:\n- **Dtype Optimization**: Automatic conversion to memory-efficient data types\n- **Sparse Data Handling**: Efficient storage for datasets with many zeros/nulls\n- **Chunking**: Process large datasets in manageable chunks\n- **Memory Mapping**: Use memory-mapped files for very large datasets\n- **Compression**: Apply compression for storage and memory efficiency\n\n**Memory Analysis**:\n1. Detailed memory usage profiling by column and data type\n2. Identification of memory optimization opportunities\n3. Impact assessment of different optimization strategies\n4. Performance benchmarking before and after optimization\n5. Recommendations for optimal memory configuration\n\n**Chunking Strategies**:\n- **Fixed Size**: Process data in fixed-size chunks\n- **Adaptive**: Dynamic chunk sizing based on memory availability\n- **Column-wise**: Process columns independently for wide datasets\n- **Time-based**: Chunk temporal data by time periods\n- **Stratified**: Maintain data distribution across chunks\n\n**Performance Features**:\n- Parallel processing for chunk operations\n- Progress tracking for long-running optimizations\n- Memory usage monitoring and alerts\n- Automatic garbage collection and cleanup\n- Performance metrics and benchmarking\n\n**Optimization Results**:\n- Memory usage reduction statistics\n- Processing speed improvements\n- Storage space savings\n- Optimal configuration recommendations\n- Performance comparison metrics\n\n**Prerequisites**: Data must be accessible and memory usage must be a concern\n**Tools to use before this**: profile_data() for memory analysis\n**Tools to use after this**: Continue with optimized data processing\n\nUse this tool when:\n- Working with large datasets that exceed memory\n- Optimizing data processing performance\n- Reducing memory footprint for applications\n- Preparing data for memory-constrained environments\n- Improving overall system efficiency", "function_name": "optimize_memory_tool"}, {"name": "profile_data", "description": "Comprehensive data profiling with detailed statistical analysis and quality assessment.\n\nThis tool provides dataset overview including shape, data types, missing values,\nvalue distributions, statistical summaries, and data quality metrics for thorough\ndata exploration and understanding.\n\n**Profiling Components**:\n- **Dataset Overview**: Shape, size, memory usage, and basic statistics\n- **Column Analysis**: Data types, unique values, missing values, and distributions\n- **Data Quality**: Completeness, consistency, validity, and accuracy metrics\n- **Statistical Summary**: Descriptive statistics and distribution analysis\n- **Correlation Analysis**: Variable relationships and dependencies (optional)\n- **Pattern Detection**: Common patterns and anomalies in the data\n\n**Quality Assessment**:\n1. Data completeness analysis and missing value patterns\n2. Data consistency checks and validation\n3. Outlier detection and anomaly identification\n4. Duplicate analysis and record uniqueness\n5. Data freshness and currency assessment\n\n**Distribution Analysis**:\n- Frequency distributions for categorical variables\n- Histogram analysis for numerical variables\n- Percentile analysis and quartile distributions\n- Skewness and kurtosis measurements\n- Normality testing and distribution fitting\n\n**Advanced Features**:\n- Correlation matrix computation and analysis\n- Principal component analysis for dimensionality insight\n- Clustering analysis for pattern identification\n- Time series profiling for temporal data\n- Text analysis for string columns\n\n**Sampling Strategy**:\n- Intelligent sampling for large datasets\n- Stratified sampling to maintain data distribution\n- Random sampling with statistical validity\n- Time-based sampling for temporal data\n- Quality-preserving sampling techniques\n\n**Prerequisites**: Data must be loaded and accessible\n**Tools to use after this**: Based on profiling results, use appropriate cleaning or analysis tools\n\nUse this tool when:\n- Exploring new datasets for the first time\n- Understanding data characteristics and quality\n- Planning data analysis and modeling strategies\n- Documenting data for stakeholders\n- Identifying data quality issues and opportunities", "function_name": "profile_data_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "load_data", "description": "Load and parse data from CSV, Excel, JSON, Parquet, or HDF5 files with optional column selection and row limiting.", "function_name": "load_data"}, {"name": "save_data", "description": "Save data to CSV, Excel, JSON, Parquet, or HDF5 with auto-detected format and optional index inclusion.", "function_name": "save_data"}, {"name": "statistical_summary", "description": "Compute descriptive statistics, distribution analysis, and outlier detection for numerical and categorical columns.", "function_name": "statistical_summary"}, {"name": "correlation_analysis", "description": "Compute correlation matrices (Pearson, Spearman, or Kendall) with significance testing and strong-correlation detection.", "function_name": "correlation_analysis"}, {"name": "hypothesis_testing", "description": "Run statistical hypothesis tests (t-test, chi-square, ANOVA, normality, Mann-Whitney) with p-values and effect sizes.", "function_name": "hypothesis_testing"}, {"name": "handle_missing_data", "description": "Detect, impute, or remove missing values using strategies like mean/median/mode fill, forward/backward fill, or interpolation.", "function_name": "handle_missing_data"}, {"name": "clean_data", "description": "Remove duplicates, detect outliers via IQR/Z-score, and optimize data types in a single pass.", "function_name": "clean_data"}, {"name": "groupby_operations", "description": "Group data by columns and apply aggregations (sum, mean, count, min, max, std, median) with optional pre-filter.", "function_name": "groupby_operations"}, {"name": "merge_datasets", "description": "Join two datasets using inner, outer, left, or right joins on specified key columns.", "function_name": "merge_datasets"}, {"name": "pivot_table", "description": "Create pivot tables with configurable row index, column headers, value columns, and aggregation function.", "function_name": "pivot_table"}, {"name": "time_series_operations", "description": "Resample, compute rolling statistics, create lag features, or difference a time series.", "function_name": "time_series_operations"}, {"name": "validate_data", "description": "Validate columns against rules for min/max range, data type, nullability, uniqueness, and regex patterns.", "function_name": "validate_data"}, {"name": "filter_data", "description": "Filter rows using comparison, membership, pattern-matching, and null-check operators across multiple columns.", "function_name": "filter_data"}, {"name": "optimize_memory", "description": "Analyze and reduce DataFrame memory usage through automatic dtype optimization and chunked-processing recommendations.", "function_name": "optimize_memory"}, {"name": "profile_data", "description": "Generate a full dataset profile: shape, types, missing values, distributions, quality checks, and optional correlations.", "function_name": "profile_data"}]} > ### 1. Data Loading and Profiling diff --git a/clio-kit-website/docs/mcps/parallel_sort.md b/clio-kit-website/docs/mcps/parallel_sort.md index 46859ede..6a3040b4 100644 --- a/clio-kit-website/docs/mcps/parallel_sort.md +++ b/clio-kit-website/docs/mcps/parallel_sort.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["sort_log_by_timestamp", "parallel_sort_large_file", "analyze_log_statistics", "detect_log_patterns", "filter_logs", "filter_by_time_range", "filter_by_log_level", "filter_by_keyword", "apply_filter_preset", "export_to_json", "export_to_csv", "export_to_text", "generate_summary_report"]} platforms={["claude", "cursor", "vscode"]} keywords={["parallel-sorting", "log-processing", "log-analysis", "high-performance", "timestamp-sorting", "pattern-detection", "log-filtering", "data-export"]} - license="MIT" - tools={[{"name": "sort_log_by_timestamp", "description": "Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format. Handles edge cases like empty files and invalid timestamps.", "function_name": "sort_log_tool"}, {"name": "parallel_sort_large_file", "description": "Sort large log files using parallel processing with chunked approach for improved performance.", "function_name": "parallel_sort_tool"}, {"name": "analyze_log_statistics", "description": "Generate comprehensive statistics and analysis for log files including temporal patterns, log levels, and quality metrics.", "function_name": "analyze_statistics_tool"}, {"name": "detect_log_patterns", "description": "Detect patterns in log files including anomalies, error clusters, trending issues, and repeated patterns.", "function_name": "detect_patterns_tool"}, {"name": "filter_logs", "description": "Filter log entries based on multiple conditions with support for complex logical operations.", "function_name": "filter_logs_tool"}, {"name": "filter_by_time_range", "description": "Filter log entries by time range using start and end timestamps.", "function_name": "filter_time_range_tool"}, {"name": "filter_by_log_level", "description": "Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.).", "function_name": "filter_level_tool"}, {"name": "filter_by_keyword", "description": "Filter log entries by keywords in the message content with support for multiple keywords and logical operations.", "function_name": "filter_keyword_tool"}, {"name": "apply_filter_preset", "description": "Apply predefined filter presets like 'errors_only', 'warnings_and_errors', 'connection_issues', etc.", "function_name": "filter_preset_tool"}, {"name": "export_to_json", "description": "Export log processing results to JSON format with optional metadata.", "function_name": "export_json_tool"}, {"name": "export_to_csv", "description": "Export log entries to CSV format with structured columns for timestamp, level, and message.", "function_name": "export_csv_tool"}, {"name": "export_to_text", "description": "Export log entries to plain text format with optional processing summary.", "function_name": "export_text_tool"}, {"name": "generate_summary_report", "description": "Generate a comprehensive summary report of log processing results with statistics and analysis.", "function_name": "summary_report_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "sort_log_by_timestamp", "description": "Sort log file lines by timestamps in YYYY-MM-DD HH:MM:SS format.", "function_name": "sort_log_by_timestamp"}, {"name": "parallel_sort_large_file", "description": "Sort large log files using parallel processing with chunked approach.", "function_name": "parallel_sort_large_file"}, {"name": "analyze_log_statistics", "description": "Generate statistics for log files including temporal patterns and log levels.", "function_name": "analyze_log_statistics"}, {"name": "detect_log_patterns", "description": "Detect patterns in log files including anomalies and error clusters.", "function_name": "detect_log_patterns"}, {"name": "filter_logs", "description": "Filter log entries based on multiple conditions with logical operations.", "function_name": "filter_logs"}, {"name": "filter_by_time_range", "description": "Filter log entries by time range using start and end timestamps.", "function_name": "filter_by_time_range"}, {"name": "filter_by_log_level", "description": "Filter log entries by log level (ERROR, WARN, INFO, DEBUG, etc.).", "function_name": "filter_by_log_level"}, {"name": "filter_by_keyword", "description": "Filter log entries by keywords with support for multiple keywords and logical operations.", "function_name": "filter_by_keyword"}, {"name": "apply_filter_preset", "description": "Apply predefined filter presets like 'errors_only' or 'connection_issues'.", "function_name": "apply_filter_preset"}, {"name": "export_to_json", "description": "Export log processing results to JSON format.", "function_name": "export_to_json"}, {"name": "export_to_csv", "description": "Export log entries to CSV format with structured columns.", "function_name": "export_to_csv"}, {"name": "export_to_text", "description": "Export log entries to plain text format.", "function_name": "export_to_text"}, {"name": "generate_summary_report", "description": "Generate a summary report of log processing results with statistics.", "function_name": "generate_summary_report"}]} > ### 1. Large Log File Sorting and Analysis diff --git a/clio-kit-website/docs/mcps/paraview.md b/clio-kit-website/docs/mcps/paraview.md index fd9228d3..135ba0de 100644 --- a/clio-kit-website/docs/mcps/paraview.md +++ b/clio-kit-website/docs/mcps/paraview.md @@ -1,167 +1,53 @@ --- -title: ParaView MCP -description: "ParaView MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 29 tools for scientific 3D visualization: load scientific data, generate isosurfaces, create slices, volume rendering, flow streamlines, color mapping, histogram analysis, ADIOS2/BP5 support. Enables AI agents to create autonomous scientific visualizations." +title: Paraview MCP +description: "ParaView MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). 29 tools for scientific 3D visualization: load scientific data, generate isosurfaces, create slices, volume rendering, flow streamlines, color mapping, histogram analysis, ADIOS2/BP5 support. Enables AI agents to create autonomous scientif..." --- import MCPDetail from '@site/src/components/MCPDetail'; -### 1. Basic Scientific Data Visualization +### Basic Scientific Data Visualization ``` Load /data/simulation_output.vtk with temperature data, create an isosurface at temperature 300, apply Blue to Red color map preset, and take a high-resolution screenshot. ``` -**Tools called:** -- `load_scientific_data` - Load VTK simulation data -- `generate_isosurface` - Create isosurface at temperature 300 -- `set_color_map_preset` - Apply "Blue to Red White" preset -- `take_viewport_screenshot` - Capture visualization - -### 2. Volume Visualization with Flow Analysis +### Volume Visualization with Flow Analysis ``` -Using /data/fluid_dynamics.bp5, create volume rendering of pressure field with Rainbow color map, +Using /data/fluid_dynamics.bp5, create volume rendering of pressure field with Rainbow color map, add streamlines to visualize flow patterns, and adjust opacity for better visibility. ``` -**Tools called:** -- `load_scientific_data` - Load ADIOS2/BP5 fluid dynamics data -- `configure_volume_display` - Enable volume rendering -- `set_color_map_preset` - Apply "Rainbow" preset -- `generate_flow_streamlines` - Create flow streamlines -- `adjust_volume_opacity` - Edit opacity transfer function -- `take_viewport_screenshot` - Document result - -### 3. Multi-Slice Data Exploration +### Multi-Slice Data Exploration ``` Load /data/medical_scan.vti, get array info to identify density field, create three orthogonal slices through the center, color by density field using Viridis preset, and export slices to VTK format. ``` -**Tools called:** -- `load_scientific_data` - Load medical imaging data -- `list_arrays` - Get available data arrays -- `create_data_slice` - Create XY, XZ, YZ slices -- `apply_field_coloring` - Color by density -- `set_color_map_preset` - Apply "Viridis" preset -- `export_data` - Export to VTK format -- `take_viewport_screenshot` - Capture multi-slice view - -### 4. Advanced ADIOS2/BP5 Analysis -``` -Query metadata from /data/checkpoint.bp5 to list available timesteps and variables, convert to VTK format, -create histogram of temperature distribution, apply threshold filter to extract hot regions (>500K), -and visualize with appropriate color mapping. -``` - -**Tools called:** -- `query_adios2_metadata` - Query BP5 file metadata -- `convert_bp5_to_vtk` - Convert to VTK format -- `load_scientific_data` - Load converted data -- `get_histogram` - Analyze temperature distribution -- `apply_threshold_filter` - Extract hot regions -- `set_color_map_preset` - Apply "Inferno" preset -- `take_viewport_screenshot` - Document analysis - -### 5. Comparative Isosurface Analysis +### Advanced ADIOS2/BP5 Analysis ``` -From /data/pressure_field.vtk, get array range for pressure, create multiple isosurfaces at pressure -values 100, 200, and 300 as wireframe for comparison. +Query metadata from /data/checkpoint.bp5 to list available timesteps and variables, +convert to VTK format, create histogram of temperature distribution, apply threshold filter +to extract hot regions (>500K), and visualize with appropriate color mapping. ``` -**Tools called:** -- `load_scientific_data` - Load pressure field data -- `get_array_range` - Get pressure value range -- `generate_isosurface` - Create multiple isosurfaces -- `set_representation` - Set wireframe representation -- `apply_field_coloring` - Apply pressure-based coloring -- `set_color_map_preset` - Apply "Cool to Warm" preset - -### 6. Interactive Camera Control +### Interactive Camera Control ``` -Load /data/molecule.vtk, create isosurface of electron density, rotate camera 45 degrees around Y axis, +Load /data/molecule.vtk, create isosurface of electron density, rotate camera 45 degrees around Y axis, zoom in to focus on binding site, set camera position for optimal viewing angle, and save multiple viewpoints. ``` -**Tools called:** -- `load_scientific_data` - Load molecular data -- `generate_isosurface` - Create electron density isosurface -- `rotate_camera` - Rotate 45° around Y axis -- `adjust_camera_zoom` - Zoom to binding site -- `set_camera_position` - Set optimal view -- `take_viewport_screenshot` - Save multiple angles - -### 7. Advanced Filtering Pipeline -``` -Load /data/turbulent_flow.bp5, examine available fields, create a calculator to compute velocity magnitude, -apply clip filter to focus on region of interest, warp by velocity vector, and visualize results. -``` - -**Tools called:** -- `load_scientific_data` - Load turbulent flow simulation -- `list_arrays` - Examine available data fields -- `apply_calculator` - Compute derived velocity magnitude -- `apply_clip_filter` - Focus on specific region -- `apply_warp_by_vector` - Warp by velocity -- `set_color_map_preset` - Apply "Plasma" preset -- `take_viewport_screenshot` - Document pipeline result - -### 8. Data Quality Assessment -``` -Load /data/experimental_results.csv, check data info and available fields, create histogram to assess -distribution, toggle visibility of different components, and create the most appropriate 3D visualization. -``` - -**Tools called:** -- `load_scientific_data` - Load experimental CSV data -- `get_data_info` - Get dataset information -- `list_arrays` - Analyze available data fields -- `get_histogram` - Assess data distribution -- `toggle_object_visibility` - Control component visibility -- `apply_field_coloring` - Apply appropriate field coloring -- `set_background_color` - Set presentation background -- `take_viewport_screenshot` - Document visualization + - \ No newline at end of file diff --git a/clio-kit-website/docs/mcps/parquet.md b/clio-kit-website/docs/mcps/parquet.md index 7b3c92d9..0e93c230 100644 --- a/clio-kit-website/docs/mcps/parquet.md +++ b/clio-kit-website/docs/mcps/parquet.md @@ -11,104 +11,31 @@ import MCPDetail from '@site/src/components/MCPDetail'; category="Data Processing" description="Parquet MCP v1.0.0 - Part of CLIO Kit (IoWarp Platform). Tools for Parquet file operations: read columns, preview data, analyze schemas. Enables AI agents to work with columnar data formats efficiently." version="1.0.0" - actions={[]} + actions={["summarize_tool", "read_slice_tool", "get_column_preview_tool", "aggregate_column_tool"]} platforms={["claude", "cursor", "vscode"]} - keywords={["Parquet", "columnar", "data", "analytics", "pandas"]} - license="MIT" - tools={[]} + keywords={["parquet", "columnar-data", "data-analysis", "scientific-computing", "mcp", "llm-integration", "apache-arrow"]} + license="BSD-3-Clause" + tools={[{"name": "summarize_tool", "description": "Return Parquet schema, row count, and file size.", "function_name": "summarize_tool"}, {"name": "read_slice_tool", "description": "Read a row slice from a Parquet file with optional column projection and filtering.", "function_name": "read_slice_tool"}, {"name": "get_column_preview_tool", "description": "Preview values from a specific column with pagination.", "function_name": "get_column_preview_tool"}, {"name": "aggregate_column_tool", "description": "Compute aggregate statistics (min, max, mean, etc.) on a Parquet column.", "function_name": "aggregate_column_tool"}]} > -### 1. Data Discovery and Schema Analysis -``` -I have Parquet files in my data directory. Can you discover all available files and show me their schemas to understand the data structure? -``` - -**Tools called:** -- `list_parquet_resources` - Discover available Parquet files -- `get_parquet_schema` - Analyze file schemas and structure - -This prompt will: -- Use `list_parquet_resources` to discover all available Parquet files -- Extract schema information using `get_parquet_schema` for each file -- Provide comprehensive overview of data structure and organization -- Enable informed data analysis planning - -### 2. Selective Column Analysis -``` -From the weather data file at /data/weather_measurements.parquet, read the temperature column and show me the data distribution and statistics. -``` - -**Tools called:** -- `read_parquet_column` - Read temperature column data -- `get_parquet_schema` - Get column metadata and types - -This prompt will: -- Read temperature column using `read_parquet_column` with optimized memory usage -- Extract column metadata using `get_parquet_schema` -- Provide statistical analysis and data distribution insights -- Support focused analytical workflows - -### 3. Data Quality Assessment -``` -Before processing the large dataset at /analytics/customer_data.parquet, preview the first 50 rows to validate data quality and structure. -``` -**Tools called:** -- `preview_parquet_data` - Preview dataset sample -- `get_parquet_schema` - Get comprehensive schema information - -This prompt will: -- Preview sample data using `preview_parquet_data` with specified row count -- Analyze data structure using `get_parquet_schema` -- Enable data quality validation before full processing -- Support data validation and preprocessing workflows - -### 4. Multi-Column Data Exploration -``` -Explore the sales dataset at /business/quarterly_sales.parquet by reading the revenue, region, and date columns for trend analysis. -``` - -**Tools called:** -- `read_parquet_column` - Read multiple columns (revenue, region, date) -- `preview_parquet_data` - Preview multi-column data sample - -This prompt will: -- Read multiple columns using `read_parquet_column` for each required field -- Preview multi-column data using `preview_parquet_data` -- Enable comprehensive trend analysis and business intelligence -- Support multi-dimensional data exploration - -### 5. Large Dataset Processing Preparation -``` -I need to process a large Parquet dataset at /warehouse/transaction_logs.parquet. Show me the schema, preview sample data, and help me understand the optimal columns for analysis. +### Basic Usage +```python +# Load and process data with Parquet +data = load_data("input_file") +processed_data = process_data(data) +save_data(processed_data, "output_file") ``` -**Tools called:** -- `get_parquet_schema` - Analyze dataset structure -- `preview_parquet_data` - Sample data for understanding -- `list_parquet_resources` - Verify resource availability - -This prompt will: -- Analyze dataset structure using `get_parquet_schema` -- Preview sample data using `preview_parquet_data` -- Verify resource availability using `list_parquet_resources` -- Provide optimization recommendations for large dataset processing - -### 6. Business Intelligence Data Pipeline -``` -Set up analysis of our customer behavior data stored in /bi/customer_analytics.parquet by examining schema, previewing key metrics columns, and reading engagement data. +### Integration Example +```python +# Use Parquet in a data pipeline +for file in data_files: + data = load_data(file) + result = analyze_data(data) + export_results(result, f"analysis_{file}") ``` -**Tools called:** -- `get_parquet_schema` - Understand data structure -- `preview_parquet_data` - Preview key metrics -- `read_parquet_column` - Read engagement data columns - -This prompt will: -- Analyze data structure using `get_parquet_schema` -- Preview key business metrics using `preview_parquet_data` -- Extract engagement data using `read_parquet_column` -- Support business intelligence and analytics workflows diff --git a/clio-kit-website/docs/mcps/plot.md b/clio-kit-website/docs/mcps/plot.md index 5cc3d836..06116bc8 100644 --- a/clio-kit-website/docs/mcps/plot.md +++ b/clio-kit-website/docs/mcps/plot.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["line_plot", "bar_plot", "scatter_plot", "histogram_plot", "heatmap_plot", "data_info"]} platforms={["claude", "cursor", "vscode"]} keywords={["MCP", "plotting", "visualization", "analytics", "matplotlib", "seaborn", "data-science"]} - license="MIT" - tools={[{"name": "line_plot", "description": "Create line plots from CSV or Excel data with customizable styling and formatting. Supports multiple data series, trend analysis, and time-series visualization with advanced customization options.", "function_name": "line_plot_tool"}, {"name": "bar_plot", "description": "Create bar charts from CSV or Excel data with advanced styling and categorical data visualization. Supports grouped bars, stacked bars, and horizontal orientation with customizable colors and annotations.", "function_name": "bar_plot_tool"}, {"name": "scatter_plot", "description": "Create scatter plots from CSV or Excel data with correlation analysis and trend visualization. Supports multi-dimensional data exploration, regression lines, and statistical annotations for data relationships.", "function_name": "scatter_plot_tool"}, {"name": "histogram_plot", "description": "Create histograms from CSV or Excel data with statistical distribution analysis. Supports density plots, normal distribution overlays, and comprehensive statistical metrics for data distribution visualization.", "function_name": "histogram_plot_tool"}, {"name": "heatmap_plot", "description": "Create heatmaps from CSV or Excel data with correlation matrix analysis and color-coded data visualization. Supports hierarchical clustering, dendrograms, and advanced color mapping for multi-dimensional data exploration.", "function_name": "heatmap_plot_tool"}, {"name": "data_info", "description": "Get comprehensive data file information including detailed schema analysis, data quality assessment, and statistical profiling. Provides thorough data exploration with column types, distributions, and data health metrics.", "function_name": "data_info_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "line_plot", "description": "Create a line plot from CSV or Excel data with customizable styling.", "function_name": "line_plot"}, {"name": "bar_plot", "description": "Create a bar chart from CSV or Excel data with categorical grouping.", "function_name": "bar_plot"}, {"name": "scatter_plot", "description": "Create a scatter plot from CSV or Excel data for correlation analysis.", "function_name": "scatter_plot"}, {"name": "histogram_plot", "description": "Create a histogram from CSV or Excel data showing value distribution.", "function_name": "histogram_plot"}, {"name": "heatmap_plot", "description": "Create a correlation heatmap from numeric columns in CSV or Excel data.", "function_name": "heatmap_plot"}, {"name": "data_info", "description": "Get schema, column types, and summary statistics for a CSV or Excel file.", "function_name": "data_info"}]} > ### 1. Data Exploration and Analysis diff --git a/clio-kit-website/docs/mcps/slurm.md b/clio-kit-website/docs/mcps/slurm.md index b4b3ef7e..20943be6 100644 --- a/clio-kit-website/docs/mcps/slurm.md +++ b/clio-kit-website/docs/mcps/slurm.md @@ -14,8 +14,8 @@ import MCPDetail from '@site/src/components/MCPDetail'; actions={["submit_slurm_job", "check_job_status", "cancel_slurm_job", "list_slurm_jobs", "get_slurm_info", "get_job_details", "get_job_output", "get_queue_info", "submit_array_job", "get_node_info", "allocate_slurm_nodes", "deallocate_slurm_nodes", "get_allocation_status"]} platforms={["claude", "cursor", "vscode"]} keywords={["MCP", "Slurm", "HPC", "job-management", "cluster-monitoring", "workload-management", "scientific-computing", "high-performance-computing"]} - license="MIT" - tools={[{"name": "submit_slurm_job", "description": "Submit Slurm jobs with comprehensive resource specification and intelligent job optimization.\n\nThis powerful tool provides complete job submission capabilities by accepting script files and resource requirements,\nthen submitting them to the Slurm scheduler with advanced parameter validation, intelligent optimization, and \ncomprehensive job lifecycle management.\n\n**Intelligent Job Submission Strategy**:\n1. **Resource Validation**: Comprehensive validation of CPU, memory, and time requirements with intelligent defaults and optimization\n2. **Script Analysis**: Automatic analysis of script requirements and compatibility with cluster capabilities\n3. **Queue Selection**: Smart partition and queue selection based on resource requirements, availability, and historical performance\n4. **Intelligent Scheduling**: AI-powered scheduling recommendations based on cluster state, job characteristics, and performance patterns\n5. **Performance Optimization**: Resource allocation optimization with efficiency analysis and cost-effectiveness recommendations\n\n**Advanced Job Submission Features**:\n- **Resource Requirements**: CPU cores, memory allocation, time limits with intelligent scaling and optimization\n- **Queue Management**: Automatic partition selection with load balancing and performance optimization\n- **Job Naming**: Intelligent job naming with metadata tracking and organization\n- **Script Validation**: Comprehensive script analysis with compatibility checking and optimization suggestions\n- **Resource Efficiency**: Automatic resource optimization with usage prediction and cost analysis\n- **Job Prioritization**: Smart priority assignment based on resource requirements and cluster policies\n\n**Optimization Intelligence**:\n- **Resource Sizing**: Intelligent resource recommendation based on script analysis and historical data\n- **Queue Selection**: Optimal partition selection based on resource availability and job characteristics\n- **Time Estimation**: Intelligent time limit suggestions based on workload analysis and cluster performance\n- **Cost Optimization**: Resource allocation optimization for cost-effectiveness and efficiency\n- **Performance Prediction**: Job performance estimation with bottleneck identification and optimization\n\n**Prerequisites**: Valid Slurm cluster access with job submission capabilities and script file availability\n**Tools to use before this**: get_slurm_info() to verify cluster capabilities, get_queue_info() for availability analysis\n**Tools to use after this**: check_job_status() for monitoring, get_job_details() for analysis, get_job_output() for results\n\nUse this tool when:\n- Submitting computational jobs to HPC clusters with optimized resource allocation (\"Submit my parallel simulation with intelligent resource optimization\")\n- Deploying batch workloads with specific resource requirements and intelligent scheduling optimization\n- Running scientific applications with AI-powered resource allocation and performance monitoring\n- Executing high-throughput computing workflows with intelligent job scheduling and queue management\n- Optimizing job submission for cost-effectiveness and performance efficiency with predictive analysis", "function_name": "submit_slurm_job_tool"}, {"name": "check_job_status", "description": "Check comprehensive Slurm job status with advanced monitoring, performance insights, and intelligent analysis.\n\nThis powerful tool provides complete job status analysis by querying the Slurm scheduler and delivering detailed \nstatus information with intelligent analysis, performance metrics, optimization recommendations, and predictive insights\nfor comprehensive job lifecycle management.\n\n**Intelligent Job Status Analysis**:\n1. **Real-Time Monitoring**: Comprehensive job state tracking with performance analysis and trend monitoring\n2. **Performance Analytics**: Resource utilization analysis with efficiency metrics and optimization insights\n3. **Predictive Analysis**: Job completion estimation with performance trend analysis and bottleneck identification\n4. **Health Assessment**: Job health monitoring with issue detection and optimization recommendations\n5. **Resource Optimization**: Usage pattern analysis with efficiency recommendations and cost optimization\n\n**Advanced Status Information**:\n- **Job State Tracking**: Current status, queue position, execution progress with intelligent state analysis\n- **Resource Utilization**: CPU, memory, I/O usage with efficiency analysis and optimization recommendations\n- **Performance Metrics**: Runtime analysis, throughput measurement, and performance trend identification\n- **Queue Analytics**: Position analysis, estimated wait time, and scheduling optimization insights\n- **Error Detection**: Intelligent error identification with diagnostic analysis and resolution recommendations\n\n**Monitoring Intelligence**:\n- **Progress Prediction**: Intelligent job completion time estimation based on current performance and historical data\n- **Performance Analysis**: Real-time performance monitoring with bottleneck identification and optimization suggestions\n- **Resource Efficiency**: Usage pattern analysis with efficiency scoring and cost-effectiveness recommendations\n- **Issue Detection**: Automated problem identification with diagnostic insights and resolution strategies\n- **Trend Analysis**: Performance trend monitoring with predictive maintenance and optimization guidance\n\n**Optimization Insights**:\n- **Resource Usage**: Comprehensive analysis of CPU, memory, and I/O utilization with optimization recommendations\n- **Performance Optimization**: Bottleneck identification with performance improvement strategies and best practices\n- **Cost Analysis**: Resource cost analysis with optimization suggestions for future job submissions\n- **Efficiency Scoring**: Job efficiency evaluation with improvement recommendations and best practice guidance\n\n**Prerequisites**: Valid Slurm job ID from previous job submission with cluster access for monitoring\n**Tools to use before this**: submit_slurm_job() to get job ID, list_slurm_jobs() for job discovery\n**Tools to use after this**: get_job_details() for comprehensive analysis, get_job_output() for results, or cancel_slurm_job() if needed\n\nUse this tool when:\n- Monitoring job progress and execution status with intelligent performance analysis (\"Check my simulation job performance and optimization opportunities\")\n- Tracking resource utilization and performance metrics with predictive insights and efficiency recommendations\n- Identifying job issues and optimization opportunities with AI-powered diagnostic analysis and resolution strategies\n- Analyzing job performance for optimization and efficiency improvement with comprehensive metrics and recommendations\n- Monitoring job health and predicting completion times with intelligent analysis and trend monitoring", "function_name": "check_job_status_tool"}, {"name": "cancel_slurm_job", "description": "Cancel Slurm jobs with intelligent resource cleanup and comprehensive lifecycle management.\n\nThis powerful tool provides complete job cancellation capabilities with intelligent resource cleanup, \nimpact analysis, and optimization recommendations for efficient cluster resource management and \nworkflow optimization.\n\n**Intelligent Job Cancellation Strategy**:\n1. **Safe Cancellation**: Comprehensive job termination with graceful shutdown and resource cleanup\n2. **Impact Analysis**: Assessment of cancellation impact on dependent jobs and cluster resources\n3. **Resource Recovery**: Intelligent resource cleanup with optimization for cluster efficiency\n4. **Data Preservation**: Analysis of output preservation and recovery recommendations\n5. **Cost Analysis**: Resource usage analysis with cost impact assessment and optimization insights\n\n**Advanced Cancellation Features**:\n- **Graceful Termination**: Safe job termination with checkpoint preservation and data integrity\n- **Resource Cleanup**: Automatic resource deallocation with cluster optimization and efficiency analysis\n- **Impact Assessment**: Analysis of cancellation effects on job dependencies and cluster performance\n- **Data Recovery**: Intelligent analysis of recoverable outputs and checkpoint preservation strategies\n- **Queue Optimization**: Post-cancellation queue optimization with resource reallocation recommendations\n\n**Optimization Intelligence**:\n- **Resource Efficiency**: Analysis of resource recovery and cluster optimization opportunities\n- **Cost Impact**: Assessment of cancellation costs and optimization recommendations for future submissions\n- **Workflow Analysis**: Impact assessment on dependent jobs with optimization strategies\n- **Performance Insights**: Analysis of cancellation reasons with prevention recommendations and best practices\n\n**Prerequisites**: Valid Slurm job ID and appropriate permissions for job cancellation\n**Tools to use before this**: check_job_status() to verify job state, get_job_details() for impact analysis\n**Tools to use after this**: list_slurm_jobs() to verify cancellation, get_queue_info() for resource reallocation analysis\n\nUse this tool when:\n- Canceling problematic jobs with intelligent resource recovery (\"Cancel job with resource optimization analysis\")\n- Terminating jobs that are no longer needed with efficient resource cleanup and cost analysis\n- Managing job priorities with intelligent cancellation and resource reallocation strategies\n- Optimizing cluster resources through strategic job cancellation and queue management", "function_name": "cancel_slurm_job_tool"}, {"name": "list_slurm_jobs", "description": "List and analyze Slurm jobs with comprehensive filtering, intelligent analysis, and optimization insights.\n\nThis powerful tool provides complete job listing capabilities with sophisticated filtering, intelligent job analysis,\nperformance metrics, and optimization recommendations for comprehensive cluster workload management and \nworkflow optimization.\n\n**Intelligent Job Listing Strategy**:\n1. **Comprehensive Discovery**: Advanced job discovery with intelligent filtering and categorization\n2. **Performance Analysis**: Job performance evaluation with efficiency metrics and optimization insights\n3. **Resource Utilization**: Cluster resource analysis with usage patterns and optimization recommendations\n4. **Queue Intelligence**: Queue analysis with scheduling optimization and priority management insights\n5. **Workflow Optimization**: Job workflow analysis with dependency tracking and performance optimization\n\n**Advanced Job Listing Features**:\n- **Intelligent Filtering**: Sophisticated job filtering by user, state, partition, and resource requirements\n- **Performance Metrics**: Job performance analysis with efficiency scoring and optimization recommendations\n- **Resource Analytics**: Comprehensive resource utilization analysis with cluster optimization insights\n- **Queue Analysis**: Queue position analysis with scheduling optimization and priority recommendations\n- **Trend Monitoring**: Job submission and completion trend analysis with workload optimization insights\n\n**Filtering and Analysis Capabilities**:\n- **User Filtering**: Filter jobs by specific users with performance analysis and resource usage insights\n- **State Analysis**: Job state filtering with transition analysis and optimization recommendations\n- **Resource Filtering**: Filter by resource requirements with efficiency analysis and cost optimization\n- **Time-Based Analysis**: Historical job analysis with trend identification and performance optimization\n- **Partition Intelligence**: Partition-based analysis with load balancing and optimization recommendations\n\n**Optimization Intelligence**:\n- **Performance Scoring**: Job efficiency evaluation with improvement recommendations and best practice guidance\n- **Resource Optimization**: Cluster resource analysis with optimization strategies and cost-effectiveness insights\n- **Queue Optimization**: Queue management insights with scheduling optimization and priority recommendations\n- **Workflow Analysis**: Job dependency analysis with workflow optimization and efficiency improvement strategies\n\n**Prerequisites**: Slurm cluster access with job listing permissions and query capabilities\n**Tools to use before this**: get_slurm_info() for cluster overview, get_queue_info() for queue analysis\n**Tools to use after this**: check_job_status() for specific jobs, get_job_details() for comprehensive analysis\n\nUse this tool when:\n- Analyzing job queues and workload patterns with intelligent optimization insights (\"Show me all jobs with performance analysis\")\n- Monitoring cluster utilization and job efficiency with comprehensive metrics and optimization recommendations\n- Managing job priorities and resource allocation with intelligent scheduling and queue optimization strategies\n- Tracking job performance trends and identifying optimization opportunities with AI-powered analysis and recommendations", "function_name": "list_slurm_jobs_tool"}, {"name": "get_slurm_info", "description": "Get comprehensive Slurm cluster information with intelligent analysis and optimization insights.\n\nThis powerful tool provides complete cluster analysis by collecting detailed information about cluster configuration,\nresource availability, performance metrics, and optimization opportunities with intelligent recommendations for\nefficient cluster utilization and workload management.\n\n**Intelligent Cluster Analysis Strategy**:\n1. **Comprehensive Discovery**: Complete cluster configuration analysis with intelligent resource assessment\n2. **Performance Evaluation**: Cluster performance analysis with efficiency metrics and optimization insights\n3. **Resource Intelligence**: Available resource analysis with utilization patterns and optimization recommendations\n4. **Capacity Planning**: Cluster capacity analysis with growth prediction and optimization strategies\n5. **Health Assessment**: Cluster health monitoring with predictive maintenance and optimization guidance\n\n**Advanced Cluster Information**:\n- **Node Configuration**: Detailed node specifications with performance analysis and optimization recommendations\n- **Partition Analysis**: Partition configuration with load balancing and scheduling optimization insights\n- **Resource Availability**: Real-time resource status with utilization patterns and efficiency recommendations\n- **Queue Analytics**: Queue configuration analysis with optimization strategies and performance insights\n- **Performance Metrics**: Cluster performance evaluation with bottleneck identification and optimization guidance\n\n**Resource Intelligence Features**:\n- **Capacity Analysis**: Comprehensive resource capacity assessment with utilization optimization and efficiency insights\n- **Availability Tracking**: Real-time resource availability with intelligent allocation and optimization recommendations\n- **Performance Monitoring**: Cluster performance analysis with trend identification and optimization strategies\n- **Load Balancing**: Partition load analysis with balancing recommendations and optimization insights\n- **Efficiency Scoring**: Cluster efficiency evaluation with improvement recommendations and best practice guidance\n\n**Optimization Intelligence**:\n- **Resource Optimization**: Cluster resource optimization with efficiency recommendations and cost-effectiveness analysis\n- **Performance Enhancement**: Performance optimization strategies with bottleneck resolution and improvement guidance\n- **Capacity Planning**: Intelligent capacity planning with growth prediction and optimization recommendations\n- **Cost Analysis**: Resource cost analysis with optimization strategies and efficiency improvement recommendations\n\n**Prerequisites**: Slurm cluster access with cluster information query permissions\n**Tools to use before this**: None - this is typically the first tool for cluster assessment\n**Tools to use after this**: get_queue_info() for detailed queue analysis, list_slurm_jobs() for workload assessment\n\nUse this tool when:\n- Assessing cluster capabilities and resource availability with intelligent analysis (\"Show me cluster status with optimization insights\")\n- Planning job submissions with resource availability analysis and optimization recommendations\n- Monitoring cluster health and performance with predictive insights and optimization guidance\n- Analyzing cluster efficiency and identifying optimization opportunities with AI-powered recommendations and cost analysis", "function_name": "get_slurm_info_tool"}, {"name": "get_job_details", "description": "Get comprehensive Slurm job details with intelligent analysis and performance insights.\n\nThis powerful tool provides complete job information analysis by retrieving detailed job specifications,\nresource utilization metrics, and performance characteristics with intelligent insights and optimization\nrecommendations for comprehensive job lifecycle management.\n\n**Intelligent Job Details Analysis**:\n1. **Comprehensive Information**: Complete job specification analysis with resource allocation and configuration details\n2. **Performance Metrics**: Resource utilization analysis with efficiency scoring and optimization insights\n3. **Runtime Analysis**: Job execution analysis with performance trends and bottleneck identification\n4. **Resource Efficiency**: Usage pattern analysis with cost optimization and efficiency recommendations\n5. **Optimization Insights**: Job performance evaluation with improvement strategies and best practice guidance\n\n**Advanced Job Information**:\n- **Job Configuration**: Complete job specifications with resource allocation and parameter analysis\n- **Resource Utilization**: CPU, memory, I/O usage with efficiency analysis and optimization recommendations\n- **Performance Analysis**: Runtime metrics with throughput analysis and performance optimization insights\n- **Queue Analytics**: Job scheduling analysis with queue position and timing optimization insights\n- **Cost Analysis**: Resource cost evaluation with efficiency recommendations and optimization strategies\n\n**Optimization Intelligence**:\n- **Performance Evaluation**: Job efficiency scoring with improvement recommendations and best practice guidance\n- **Resource Optimization**: Usage analysis with cost-effectiveness insights and efficiency improvement strategies\n- **Runtime Analysis**: Execution performance evaluation with bottleneck identification and optimization guidance\n- **Efficiency Insights**: Resource utilization optimization with cost analysis and performance recommendations\n\n**Prerequisites**: Valid Slurm job ID with appropriate permissions for detailed job information access\n**Tools to use before this**: check_job_status() for basic status, submit_slurm_job() for job creation\n**Tools to use after this**: get_job_output() for output analysis, optimization tools based on performance insights\n\nUse this tool when:\n- Analyzing job performance and resource utilization with comprehensive metrics (\"Get detailed job analysis with optimization insights\")\n- Investigating job efficiency and identifying optimization opportunities with AI-powered recommendations\n- Monitoring resource usage patterns for cost optimization and performance improvement strategies\n- Evaluating job configurations for future optimization and efficiency enhancement recommendations", "function_name": "get_job_details_tool"}, {"name": "get_job_output", "description": "Get comprehensive Slurm job output with intelligent analysis and content organization.\n\nThis powerful tool provides complete job output retrieval and analysis by accessing stdout/stderr files\nwith intelligent content parsing, error detection, and performance insights for comprehensive job\nresult analysis and troubleshooting.\n\n**Intelligent Output Analysis**:\n1. **Content Retrieval**: Complete output file access with intelligent parsing and organization\n2. **Error Detection**: Automated error identification with diagnostic analysis and resolution recommendations\n3. **Performance Analysis**: Output-based performance evaluation with efficiency insights and optimization guidance\n4. **Content Intelligence**: Smart content analysis with pattern recognition and insight extraction\n5. **Troubleshooting Insights**: Automated issue identification with diagnostic recommendations and resolution strategies\n\n**Advanced Output Features**:\n- **Multi-Output Support**: Comprehensive stdout/stderr access with intelligent content differentiation\n- **Error Analysis**: Automated error detection with diagnostic insights and troubleshooting recommendations\n- **Performance Metrics**: Output-based performance analysis with efficiency evaluation and optimization insights\n- **Content Organization**: Intelligent output formatting with structured presentation and analysis\n- **Pattern Recognition**: Smart content analysis with trend identification and insight extraction\n\n**Optimization Intelligence**:\n- **Performance Insights**: Output-based performance evaluation with efficiency recommendations and improvement strategies\n- **Error Diagnostics**: Intelligent error analysis with resolution strategies and prevention recommendations\n- **Content Analysis**: Smart output parsing with pattern recognition and optimization guidance\n- **Troubleshooting Intelligence**: Automated issue identification with diagnostic insights and resolution recommendations\n\n**Prerequisites**: Valid Slurm job ID with output files available for analysis\n**Tools to use before this**: check_job_status() to verify completion, get_job_details() for job context\n**Tools to use after this**: Analysis tools based on output insights, troubleshooting based on error detection\n\nUse this tool when:\n- Retrieving job results with intelligent analysis and error detection (\"Get job output with performance analysis\")\n- Troubleshooting job issues with automated error detection and diagnostic recommendations\n- Analyzing job performance through output content with efficiency insights and optimization guidance\n- Investigating job execution with comprehensive output analysis and intelligent troubleshooting recommendations", "function_name": "get_job_output_tool"}, {"name": "get_queue_info", "description": "Get comprehensive Slurm queue information with intelligent analysis and optimization insights.\n\nThis powerful tool provides complete queue analysis by retrieving detailed partition information,\nresource availability, and scheduling metrics with intelligent insights and optimization recommendations\nfor efficient cluster utilization and job planning.\n\n**Intelligent Queue Analysis**:\n1. **Queue Intelligence**: Comprehensive queue status analysis with scheduling optimization and performance insights\n2. **Resource Availability**: Real-time resource status with utilization patterns and efficiency recommendations\n3. **Partition Analysis**: Detailed partition configuration with load balancing and optimization insights\n4. **Scheduling Optimization**: Queue scheduling analysis with priority optimization and performance recommendations\n5. **Capacity Planning**: Queue capacity analysis with growth prediction and optimization strategies\n\n**Advanced Queue Features**:\n- **Multi-Partition Support**: Comprehensive partition analysis with intelligent filtering and comparison\n- **Resource Analytics**: Real-time resource availability with utilization analysis and optimization recommendations\n- **Scheduling Intelligence**: Queue scheduling optimization with priority analysis and performance insights\n- **Load Balancing**: Partition load analysis with balancing recommendations and efficiency optimization\n- **Performance Metrics**: Queue performance evaluation with throughput analysis and optimization guidance\n\n**Optimization Intelligence**:\n- **Queue Optimization**: Scheduling optimization with efficiency recommendations and performance improvement strategies\n- **Resource Planning**: Capacity planning with utilization analysis and optimization recommendations\n- **Performance Enhancement**: Queue performance optimization with bottleneck identification and resolution strategies\n- **Efficiency Analysis**: Resource efficiency evaluation with cost optimization and utilization improvement guidance\n\n**Prerequisites**: Slurm cluster access with queue information query permissions\n**Tools to use before this**: get_slurm_info() for cluster overview, list_slurm_jobs() for workload context\n**Tools to use after this**: submit_slurm_job() for optimized job submission, job monitoring tools based on queue insights\n\nUse this tool when:\n- Analyzing queue status and resource availability with intelligent optimization insights (\"Show queue status with scheduling optimization\")\n- Planning job submissions with resource availability analysis and partition optimization recommendations\n- Monitoring cluster utilization and queue performance with efficiency insights and optimization guidance\n- Optimizing job scheduling and resource allocation with AI-powered queue analysis and performance recommendations", "function_name": "get_queue_info_tool"}, {"name": "submit_array_job", "description": "Submit Slurm array jobs with intelligent parallel optimization and comprehensive workflow management.\n\nThis powerful tool provides complete array job submission capabilities with intelligent parallel optimization,\nresource management, and comprehensive workflow analysis for efficient high-throughput computing and \nparallel workload optimization.\n\n**Intelligent Array Job Strategy**:\n1. **Parallel Optimization**: Intelligent parallel task distribution with efficiency analysis and performance optimization\n2. **Resource Management**: Comprehensive resource allocation with load balancing and cost optimization\n3. **Task Scheduling**: Smart task scheduling with dependency management and performance optimization\n4. **Workflow Analysis**: Array job workflow optimization with throughput analysis and efficiency recommendations\n5. **Performance Prediction**: Array job performance estimation with bottleneck identification and optimization guidance\n\n**Advanced Array Job Features**:\n- **Task Distribution**: Intelligent task distribution with load balancing and parallel optimization\n- **Resource Allocation**: Per-task resource optimization with efficiency analysis and cost-effectiveness recommendations\n- **Scheduling Intelligence**: Smart array job scheduling with priority optimization and performance analysis\n- **Dependency Management**: Task dependency analysis with workflow optimization and efficiency improvements\n- **Throughput Optimization**: Array job throughput maximization with resource efficiency and performance optimization\n\n**Parallel Computing Intelligence**:\n- **Task Parallelization**: Intelligent task parallelization with efficiency optimization and performance analysis\n- **Resource Scaling**: Dynamic resource scaling with cost optimization and performance recommendations\n- **Load Balancing**: Task load balancing with cluster optimization and efficiency maximization\n- **Performance Analytics**: Parallel performance analysis with bottleneck identification and optimization strategies\n- **Efficiency Scoring**: Array job efficiency evaluation with improvement recommendations and best practice guidance\n\n**Optimization Intelligence**:\n- **Throughput Maximization**: Array job throughput optimization with resource efficiency and cost-effectiveness analysis\n- **Resource Efficiency**: Per-task resource optimization with utilization analysis and cost optimization\n- **Performance Optimization**: Parallel performance optimization with bottleneck resolution and efficiency improvements\n- **Cost Analysis**: Array job cost analysis with optimization strategies and efficiency recommendations\n\n**Prerequisites**: Valid script file and Slurm cluster access with array job submission capabilities\n**Tools to use before this**: get_slurm_info() for cluster assessment, get_queue_info() for resource planning\n**Tools to use after this**: check_job_status() for monitoring, list_slurm_jobs() for array job tracking\n\nUse this tool when:\n- Running high-throughput parallel computations with intelligent resource optimization (\"Submit array job with parallel optimization\")\n- Processing large datasets with parallel efficiency and cost optimization\n- Executing parameter sweeps with intelligent task distribution and performance optimization\n- Managing parallel workflows with comprehensive resource allocation and efficiency analysis", "function_name": "submit_array_job_tool"}, {"name": "get_node_info", "description": "Get comprehensive Slurm node information with intelligent analysis and resource optimization insights.\n\nThis powerful tool provides complete node analysis by retrieving detailed node specifications,\nresource availability, and performance characteristics with intelligent insights and optimization\nrecommendations for efficient cluster resource management and allocation planning.\n\n**Intelligent Node Analysis**:\n1. **Node Discovery**: Comprehensive node configuration analysis with resource assessment and availability tracking\n2. **Resource Intelligence**: Node resource analysis with utilization patterns and efficiency recommendations\n3. **Performance Evaluation**: Node performance analysis with efficiency metrics and optimization insights\n4. **Availability Analysis**: Real-time node availability assessment with allocation optimization recommendations\n5. **Health Monitoring**: Node health assessment with predictive maintenance and optimization guidance\n\n**Advanced Node Features**:\n- **Multi-Node Analysis**: Comprehensive node cluster analysis with intelligent comparison and optimization\n- **Resource Analytics**: Node resource utilization with efficiency analysis and allocation recommendations\n- **Performance Metrics**: Node performance evaluation with throughput analysis and optimization insights\n- **Availability Intelligence**: Real-time availability tracking with optimal allocation strategies\n- **Health Assessment**: Node health monitoring with predictive maintenance and efficiency optimization\n\n**Optimization Intelligence**:\n- **Resource Optimization**: Node resource allocation optimization with efficiency recommendations and cost analysis\n- **Performance Enhancement**: Node performance optimization with bottleneck identification and resolution strategies\n- **Allocation Planning**: Intelligent node allocation planning with resource optimization and efficiency insights\n- **Capacity Analysis**: Node capacity evaluation with utilization optimization and growth planning recommendations\n\n**Prerequisites**: Slurm cluster access with node information query permissions\n**Tools to use before this**: get_slurm_info() for cluster overview, get_queue_info() for resource context\n**Tools to use after this**: allocate_slurm_nodes() for node allocation, job submission tools based on node availability\n\nUse this tool when:\n- Analyzing node resources and availability with intelligent optimization insights (\"Show node status with resource optimization\")\n- Planning resource allocation with node availability analysis and optimization recommendations\n- Monitoring cluster hardware and node performance with efficiency insights and optimization guidance\n- Optimizing resource utilization and node allocation with AI-powered analysis and performance recommendations", "function_name": "get_node_info_tool"}, {"name": "allocate_slurm_nodes", "description": "Allocate Slurm nodes with intelligent resource optimization and comprehensive interactive session management.\n\nThis powerful tool provides complete node allocation capabilities using salloc for interactive sessions and resource\nreservation with intelligent resource optimization, performance analysis, and comprehensive allocation management for\nefficient cluster utilization and interactive workload optimization.\n\n**Intelligent Node Allocation Strategy**:\n1. **Resource Optimization**: Intelligent resource allocation with efficiency analysis and cost optimization\n2. **Availability Analysis**: Real-time node availability assessment with optimal allocation recommendations\n3. **Performance Prediction**: Allocation performance estimation with optimization insights and efficiency analysis\n4. **Interactive Management**: Comprehensive interactive session management with resource monitoring and optimization\n5. **Efficiency Optimization**: Resource utilization optimization with cost-effectiveness analysis and performance insights\n\n**Advanced Allocation Features**:\n- **Smart Resource Selection**: Intelligent node selection based on workload requirements and cluster optimization\n- **Interactive Session Management**: Comprehensive session lifecycle management with performance monitoring and optimization\n- **Resource Efficiency**: Allocation efficiency analysis with cost optimization and utilization recommendations\n- **Performance Monitoring**: Real-time allocation performance tracking with optimization insights and efficiency analysis\n- **Availability Intelligence**: Node availability analysis with optimal timing recommendations and resource optimization\n\n**Optimization Intelligence**:\n- **Resource Sizing**: Intelligent resource recommendation based on workload analysis and historical performance data\n- **Node Selection**: Optimal node selection with performance analysis and efficiency optimization\n- **Cost Optimization**: Resource allocation cost analysis with efficiency recommendations and optimization strategies\n- **Performance Prediction**: Allocation performance estimation with bottleneck identification and optimization guidance\n- **Utilization Analysis**: Resource utilization analysis with efficiency scoring and optimization recommendations\n\n**Interactive Session Intelligence**:\n- **Session Optimization**: Interactive session performance optimization with resource efficiency and cost analysis\n- **Resource Monitoring**: Real-time resource usage monitoring with optimization insights and efficiency recommendations\n- **Performance Analytics**: Session performance analysis with bottleneck identification and optimization strategies\n- **Efficiency Tracking**: Resource efficiency monitoring with optimization recommendations and cost-effectiveness analysis\n\n**Prerequisites**: Slurm cluster access with node allocation permissions and interactive session capabilities\n**Tools to use before this**: get_slurm_info() for cluster assessment, get_node_info() for availability analysis\n**Tools to use after this**: get_allocation_status() for monitoring, deallocate_slurm_nodes() for cleanup\n\nUse this tool when:\n- Creating interactive computing sessions with optimized resource allocation (\"Allocate nodes for interactive analysis with performance optimization\")\n- Reserving cluster resources for interactive workloads with intelligent resource management and cost optimization\n- Setting up development environments with optimal resource allocation and efficiency monitoring\n- Managing interactive sessions with comprehensive performance analysis and optimization recommendations", "function_name": "allocate_slurm_nodes_tool"}, {"name": "deallocate_slurm_nodes", "description": "Deallocate Slurm nodes with intelligent resource cleanup and optimization analysis.\n\nThis powerful tool provides complete node deallocation capabilities with intelligent resource cleanup,\nimpact analysis, and optimization recommendations for efficient cluster resource management and\nallocation lifecycle optimization.\n\n**Intelligent Deallocation Strategy**:\n1. **Safe Deallocation**: Comprehensive allocation termination with resource cleanup and optimization\n2. **Impact Analysis**: Assessment of deallocation impact on cluster resources and performance\n3. **Resource Recovery**: Intelligent resource cleanup with cluster optimization and efficiency analysis\n4. **Data Preservation**: Analysis of session data preservation and recovery recommendations\n5. **Optimization Insights**: Resource usage analysis with efficiency recommendations and cost optimization\n\n**Advanced Deallocation Features**:\n- **Graceful Termination**: Safe allocation termination with session preservation and data integrity\n- **Resource Cleanup**: Automatic resource recovery with cluster optimization and efficiency analysis\n- **Impact Assessment**: Analysis of deallocation effects on cluster performance and resource availability\n- **Session Recovery**: Intelligent analysis of recoverable session data and checkpoint preservation strategies\n- **Queue Optimization**: Post-deallocation queue optimization with resource reallocation recommendations\n\n**Optimization Intelligence**:\n- **Resource Efficiency**: Analysis of resource recovery and cluster optimization opportunities\n- **Cost Impact**: Assessment of allocation costs with optimization recommendations for future allocations\n- **Performance Insights**: Analysis of allocation usage with efficiency recommendations and best practices\n- **Utilization Analysis**: Resource utilization evaluation with optimization guidance and efficiency improvements\n\n**Prerequisites**: Valid allocation ID and appropriate permissions for node deallocation\n**Tools to use before this**: get_allocation_status() to verify allocation state, allocate_slurm_nodes() for allocation context\n**Tools to use after this**: get_node_info() to verify resource recovery, optimization tools based on usage analysis\n\nUse this tool when:\n- Cleaning up completed interactive sessions with intelligent resource recovery (\"Deallocate nodes with resource optimization\")\n- Terminating allocations that are no longer needed with efficient resource cleanup and cost analysis\n- Managing allocation lifecycle with intelligent resource management and optimization strategies\n- Optimizing cluster resources through strategic allocation cleanup and resource reallocation", "function_name": "deallocate_slurm_nodes_tool"}, {"name": "get_allocation_status", "description": "Get comprehensive Slurm allocation status with intelligent monitoring and performance insights.\n\nThis powerful tool provides complete allocation status analysis by retrieving detailed allocation information,\nresource utilization metrics, and performance characteristics with intelligent insights and optimization\nrecommendations for efficient interactive session management.\n\n**Intelligent Allocation Monitoring**:\n1. **Status Analysis**: Comprehensive allocation status tracking with performance analysis and trend monitoring\n2. **Resource Monitoring**: Real-time resource utilization analysis with efficiency metrics and optimization insights\n3. **Performance Analytics**: Allocation performance evaluation with efficiency scoring and optimization recommendations\n4. **Usage Intelligence**: Resource usage pattern analysis with cost optimization and efficiency recommendations\n5. **Optimization Insights**: Allocation efficiency evaluation with improvement strategies and best practice guidance\n\n**Advanced Allocation Status**:\n- **Real-Time Monitoring**: Comprehensive allocation tracking with performance analysis and resource utilization insights\n- **Resource Analytics**: CPU, memory, node usage with efficiency analysis and optimization recommendations\n- **Performance Metrics**: Allocation performance evaluation with throughput analysis and optimization insights\n- **Usage Patterns**: Resource consumption analysis with efficiency scoring and cost optimization recommendations\n- **Health Assessment**: Allocation health monitoring with issue detection and optimization guidance\n\n**Optimization Intelligence**:\n- **Performance Evaluation**: Allocation efficiency scoring with improvement recommendations and best practice guidance\n- **Resource Optimization**: Usage analysis with cost-effectiveness insights and efficiency improvement strategies\n- **Utilization Analysis**: Resource consumption evaluation with optimization recommendations and efficiency insights\n- **Cost Analysis**: Allocation cost evaluation with optimization strategies and efficiency improvement recommendations\n\n**Prerequisites**: Valid allocation ID with appropriate permissions for allocation status monitoring\n**Tools to use before this**: allocate_slurm_nodes() for allocation creation, get_node_info() for resource context\n**Tools to use after this**: Resource optimization based on status insights, deallocate_slurm_nodes() for cleanup\n\nUse this tool when:\n- Monitoring allocation performance and resource utilization with intelligent analysis (\"Check allocation status with performance insights\")\n- Tracking interactive session efficiency with optimization recommendations and cost analysis\n- Analyzing allocation usage patterns for optimization and efficiency improvement strategies\n- Managing allocation lifecycle with comprehensive monitoring and intelligent optimization guidance", "function_name": "get_allocation_status_tool"}]} + license="BSD-3-Clause" + tools={[{"name": "submit_slurm_job", "description": "Submit a job script to the Slurm scheduler with resource requirements.", "function_name": "submit_slurm_job"}, {"name": "check_job_status", "description": "Check the status of a Slurm job by its ID.", "function_name": "check_job_status"}, {"name": "cancel_slurm_job", "description": "Cancel a running or pending Slurm job.", "function_name": "cancel_slurm_job"}, {"name": "list_slurm_jobs", "description": "List Slurm jobs with optional filtering by user and state.", "function_name": "list_slurm_jobs"}, {"name": "get_slurm_info", "description": "Get Slurm cluster configuration, partitions, and resource availability.", "function_name": "get_slurm_info"}, {"name": "get_job_details", "description": "Get detailed information about a specific Slurm job.", "function_name": "get_job_details"}, {"name": "get_job_output", "description": "Retrieve stdout or stderr output from a Slurm job.", "function_name": "get_job_output"}, {"name": "get_queue_info", "description": "Get Slurm queue status and partition information.", "function_name": "get_queue_info"}, {"name": "submit_array_job", "description": "Submit a Slurm array job for parallel task execution.", "function_name": "submit_array_job"}, {"name": "get_node_info", "description": "Get information about Slurm cluster nodes and their resources.", "function_name": "get_node_info"}, {"name": "allocate_slurm_nodes", "description": "Allocate Slurm nodes for an interactive session using salloc.", "function_name": "allocate_slurm_nodes"}, {"name": "deallocate_slurm_nodes", "description": "Release a Slurm node allocation by canceling it.", "function_name": "deallocate_slurm_nodes"}, {"name": "get_allocation_status", "description": "Check the status of a Slurm node allocation.", "function_name": "get_allocation_status"}]} > ### 1. Job Submission and Monitoring diff --git a/clio-kit-website/src/data/mcpData.js b/clio-kit-website/src/data/mcpData.js index 7f0a44f1..16bb4f92 100644 --- a/clio-kit-website/src/data/mcpData.js +++ b/clio-kit-website/src/data/mcpData.js @@ -1,83 +1,21 @@ // MCP data structure for tile-based showcase export const mcpData = { - "chronolog": { - "name": "Chronolog", + "adios": { + "name": "Adios", "category": "Data Processing", - "description": "Start logging sessions. Record AI interactions. Stop and save. Retrieve historical data. 4 tools for distributed logging on HPC systems.", - "icon": "\u23f0", - "actions": [ - "start_chronolog", - "record_interaction", - "stop_chronolog", - "retrieve_interaction" - ], - "stats": { - "version": "1.0.0", - "updated": "2025-11-11" - }, - "platforms": [ - "claude", - "cursor", - "vscode" - ], - "slug": "chronolog" - }, - "node_hardware": { - "name": "Node-Hardware", - "category": "Analysis & Visualization", - "description": "CPU info. Memory stats. GPU details. Disk usage. Network metrics. 11 tools for hardware monitoring. Real-time system analysis.", - "icon": "\ud83d\udcbb", - "actions": [ - "get_cpu_info", - "get_memory_info", - "get_system_info", - "get_disk_info", - "get_network_info", - "get_gpu_info", - "get_sensor_info", - "get_process_info", - "get_performance_info", - "get_remote_node_info", - "health_check" - ], - "stats": { - "version": "1.0.0", - "updated": "2025-11-11" - }, - "platforms": [ - "claude", - "cursor", - "vscode" - ], - "slug": "node_hardware" - }, - "lmod": { - "name": "Lmod", - "category": "System Management", - "description": "Load modules. Swap environments. Save collections. Spider search. 10 tools for environment module management on HPC clusters.", - "icon": "\ud83d\udce6", - "actions": [ - "module_list", - "module_avail", - "module_show", - "module_load", - "module_unload", - "module_swap", - "module_spider", - "module_save", - "module_restore", - "module_savelist" - ], + "description": "Read BP5 files. Inspect variables. Check attributes. Read at timestep. 5 tools for ADIOS2 scientific data I/O.", + "icon": "\ud83d\udcca", + "actions": [], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "lmod" + "slug": "adios" }, "arxiv": { "name": "Arxiv", @@ -101,7 +39,7 @@ export const mcpData = { ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", @@ -110,112 +48,70 @@ export const mcpData = { ], "slug": "arxiv" }, - "darshan": { - "name": "Darshan", - "category": "Analysis & Visualization", - "description": "Load logs. Analyze I/O patterns. Identify bottlenecks. Performance metrics. Compare runs. 10 tools for I/O profiling. Darshan log analysis via AI.", - "icon": "\u26a1", - "actions": [ - "load_darshan_log", - "get_job_summary", - "analyze_file_access_patterns", - "get_io_performance_metrics", - "analyze_posix_operations", - "analyze_mpiio_operations", - "identify_io_bottlenecks", - "get_timeline_analysis", - "compare_darshan_logs", - "generate_io_summary_report", - "load_darshan_log", - "get_job_summary", - "analyze_file_access_patterns", - "get_io_performance_metrics", - "analyze_posix_operations", - "analyze_mpiio_operations", - "identify_io_bottlenecks", - "get_timeline_analysis", - "compare_darshan_logs", - "generate_io_summary_report" - ], + "chronolog": { + "name": "Chronolog", + "category": "Data Processing", + "description": "Start logging sessions. Record AI interactions. Stop and save. Retrieve historical data. 4 tools for distributed logging on HPC systems.", + "icon": "\u23f0", + "actions": [], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "darshan" + "slug": "chronolog" }, - "pandas": { - "name": "Pandas", - "category": "Data Processing", - "description": "Load CSV/Excel/Parquet. Statistical analysis. Data cleaning. Correlations. Groupby operations. Time series. 15 tools for tabular data. Pandas through natural language.", - "icon": "\ud83d\udc3c", + "compression": { + "name": "Compression", + "category": "Utilities", + "description": "Compress files with GZIP. Reduce storage. Fast compression. Decompress archives. 1 simple tool for file compression operations.", + "icon": "\ud83d\udddc\ufe0f", "actions": [ - "load_data", - "save_data", - "statistical_summary", - "correlation_analysis", - "hypothesis_testing", - "handle_missing_data", - "clean_data", - "groupby_operations", - "merge_datasets", - "pivot_table", - "time_series_operations", - "validate_data", - "filter_data", - "optimize_memory", - "profile_data" + "compress_file_tool", + "decompress_file_tool" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "pandas" - }, - "parquet": { - "name": "Parquet", - "category": "Data Processing", - "description": "Read columnar data. Write Parquet files. Schema inspection. Pandas integration. Efficient for large datasets. Apache Parquet format operations.", - "icon": "\ud83d\udccb", - "actions": [], - "stats": { - "version": "1.0.0", - "updated": "2025-11-11" - }, - "platforms": [ - "claude", - "cursor", - "vscode" - ], - "slug": "parquet" + "slug": "compression" }, - "compression": { - "name": "Compression", - "category": "Utilities", - "description": "Compress files with GZIP. Reduce storage. Fast compression. Decompress archives. 1 simple tool for file compression operations.", - "icon": "\ud83d\udddc\ufe0f", + "darshan": { + "name": "Darshan", + "category": "Analysis & Visualization", + "description": "Load logs. Analyze I/O patterns. Identify bottlenecks. Performance metrics. Compare runs. 10 tools for I/O profiling. Darshan log analysis via AI.", + "icon": "\u26a1", "actions": [ - "compress_file" + "load_darshan_log", + "get_job_summary", + "analyze_file_access_patterns", + "get_io_performance_metrics", + "analyze_posix_operations", + "analyze_mpiio_operations", + "identify_io_bottlenecks", + "get_timeline_analysis", + "compare_darshan_logs", + "generate_io_summary_report" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "compression" + "slug": "darshan" }, "hdf5": { "name": "Hdf5", @@ -253,7 +149,7 @@ export const mcpData = { ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", @@ -262,28 +158,163 @@ export const mcpData = { ], "slug": "hdf5" }, - "adios": { - "name": "Adios", + "jarvis": { + "name": "Jarvis", "category": "Data Processing", - "description": "Read BP5 files. Inspect variables. Check attributes. Read at timestep. 5 tools for ADIOS2 scientific data I/O.", - "icon": "\ud83d\udcca", + "description": "Create pipelines. Build environments. Configure packages. Run workflows. 27 tools for data pipeline management. Jarvis-CD integration for HPC.", + "icon": "\ud83e\udd16", "actions": [ - "list_bp5", - "inspect_variables", - "inspect_variables_at_step", - "inspect_attributes", - "read_variable_at_step" + "update_pipeline", + "build_pipeline_env", + "create_pipeline", + "load_pipeline", + "get_pkg_config", + "append_pkg", + "configure_pkg", + "unlink_pkg", + "remove_pkg", + "run_pipeline", + "destroy_pipeline", + "jm_create_config", + "jm_load_config", + "jm_save_config", + "jm_set_hostfile", + "jm_bootstrap_from", + "jm_bootstrap_list", + "jm_reset", + "jm_list_pipelines", + "jm_cd", + "jm_list_repos", + "jm_add_repo", + "jm_remove_repo", + "jm_promote_repo", + "jm_get_repo", + "jm_construct_pkg", + "jm_graph_show", + "jm_graph_build", + "jm_graph_modify" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "adios" + "slug": "jarvis" + }, + "lmod": { + "name": "Lmod", + "category": "System Management", + "description": "Load modules. Swap environments. Save collections. Spider search. 10 tools for environment module management on HPC clusters.", + "icon": "\ud83d\udce6", + "actions": [ + "module_list", + "module_avail", + "module_show", + "module_load", + "module_unload", + "module_swap", + "module_spider", + "module_save", + "module_restore", + "module_savelist" + ], + "stats": { + "version": "1.0.0", + "updated": "2026-02-19" + }, + "platforms": [ + "claude", + "cursor", + "vscode" + ], + "slug": "lmod" + }, + "ndp": { + "name": "Ndp", + "category": "Data Processing", + "description": "List organizations. Search datasets. Get metadata. Discover research data through CKAN API. 3 tools for dataset discovery and exploration.", + "icon": "\ud83d\udd27", + "actions": [ + "list_organizations", + "search_datasets", + "get_dataset_details" + ], + "stats": { + "version": "1.0.0", + "updated": "2026-02-19" + }, + "platforms": [ + "claude", + "cursor", + "vscode" + ], + "slug": "ndp" + }, + "node_hardware": { + "name": "Node-Hardware", + "category": "Analysis & Visualization", + "description": "CPU info. Memory stats. GPU details. Disk usage. Network metrics. 11 tools for hardware monitoring. Real-time system analysis.", + "icon": "\ud83d\udcbb", + "actions": [ + "get_cpu_info", + "get_memory_info", + "get_system_info", + "get_disk_info", + "get_network_info", + "get_gpu_info", + "get_sensor_info", + "get_process_info", + "get_performance_info", + "get_remote_node_info", + "health_check" + ], + "stats": { + "version": "1.0.0", + "updated": "2026-02-19" + }, + "platforms": [ + "claude", + "cursor", + "vscode" + ], + "slug": "node_hardware" + }, + "pandas": { + "name": "Pandas", + "category": "Data Processing", + "description": "Load CSV/Excel/Parquet. Statistical analysis. Data cleaning. Correlations. Groupby operations. Time series. 15 tools for tabular data. Pandas through natural language.", + "icon": "\ud83d\udc3c", + "actions": [ + "load_data", + "save_data", + "statistical_summary", + "correlation_analysis", + "hypothesis_testing", + "handle_missing_data", + "clean_data", + "groupby_operations", + "merge_datasets", + "pivot_table", + "time_series_operations", + "validate_data", + "filter_data", + "optimize_memory", + "profile_data" + ], + "stats": { + "version": "1.0.0", + "updated": "2026-02-19" + }, + "platforms": [ + "claude", + "cursor", + "vscode" + ], + "slug": "pandas" }, "parallel_sort": { "name": "Parallel-Sort", @@ -307,7 +338,7 @@ export const mcpData = { ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", @@ -316,57 +347,71 @@ export const mcpData = { ], "slug": "parallel_sort" }, - "slurm": { - "name": "Slurm", - "category": "System Management", - "description": "Submit jobs. Check status. Allocate nodes. Read output. Full HPC cluster management through AI assistants. 13 tools for Slurm workload manager.", - "icon": "\ud83d\udda5\ufe0f", + "paraview": { + "name": "Paraview", + "category": "Analysis & Visualization", + "description": "Load scientific data. Generate isosurfaces. Create data slices. Volume rendering. Flow streamlines. 12 tools for 3D scientific visualization with ADIOS2/BP5 support.", + "icon": "\ud83d\udd27", "actions": [ - "submit_slurm_job", - "check_job_status", - "cancel_slurm_job", - "list_slurm_jobs", - "get_slurm_info", - "get_job_details", - "get_job_output", - "get_queue_info", - "submit_array_job", - "get_node_info", - "allocate_slurm_nodes", - "deallocate_slurm_nodes", - "get_allocation_status" + "load_scientific_data", + "save_contour_as_stl", + "create_geometric_shape", + "generate_isosurface", + "create_data_slice", + "configure_volume_display", + "toggle_visibility", + "set_active_source", + "get_active_source_names_by_type", + "edit_volume_opacity", + "set_color_map", + "apply_field_coloring", + "compute_surface_area", + "set_color_map_preset", + "set_representation_type", + "get_pipeline", + "get_available_arrays", + "get_histogram", + "generate_flow_streamlines", + "take_viewport_screenshot", + "show_screenshot_preview", + "rotate_camera", + "reset_camera", + "plot_over_line", + "warp_by_vector", + "list_commands" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "slurm" + "slug": "paraview" }, - "ndp": { - "name": "Ndp", + "parquet": { + "name": "Parquet", "category": "Data Processing", - "description": "List organizations. Search datasets. Get metadata. Discover research data through CKAN API. 3 tools for dataset discovery and exploration.", - "icon": "\ud83d\udd27", + "description": "Read columnar data. Write Parquet files. Schema inspection. Pandas integration. Efficient for large datasets. Apache Parquet format operations.", + "icon": "\ud83d\udccb", "actions": [ - "list_organizations", - "search_datasets", - "get_dataset_details" + "summarize_tool", + "read_slice_tool", + "get_column_preview_tool", + "aggregate_column_tool" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "ndp" + "slug": "parquet" }, "plot": { "name": "Plot", @@ -383,7 +428,7 @@ export const mcpData = { ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", @@ -392,81 +437,36 @@ export const mcpData = { ], "slug": "plot" }, - "paraview": { - "name": "ParaView", - "category": "Scientific Visualization", - "description": "Load scientific data. Generate isosurfaces. Create data slices. Volume rendering. Flow streamlines. 12 tools for 3D scientific visualization with ADIOS2/BP5 support.", - "icon": "\ud83d\udd2c", - "actions": [ - "load_scientific_data", - "generate_isosurface", - "create_data_slice", - "configure_volume_display", - "generate_flow_streamlines", - "take_viewport_screenshot", - "apply_field_coloring", - "set_representation_type", - "get_available_arrays", - "rotate_camera", - "reset_camera" - ], - "stats": { - "version": "1.0.0", - "updated": "2025-11-13" - }, - "platforms": [ - "claude", - "cursor", - "vscode" - ], - "slug": "paraview" - }, - "jarvis": { - "name": "Jarvis", - "category": "Data Processing", - "description": "Create pipelines. Build environments. Configure packages. Run workflows. 27 tools for data pipeline management. Jarvis-CD integration for HPC.", - "icon": "\ud83e\udd16", + "slurm": { + "name": "Slurm", + "category": "System Management", + "description": "Submit jobs. Check status. Allocate nodes. Read output. Full HPC cluster management through AI assistants. 13 tools for Slurm workload manager.", + "icon": "\ud83d\udda5\ufe0f", "actions": [ - "update_pipeline", - "build_pipeline_env", - "create_pipeline", - "load_pipeline", - "get_pkg_config", - "append_pkg", - "configure_pkg", - "unlink_pkg", - "remove_pkg", - "run_pipeline", - "destroy_pipeline", - "jm_create_config", - "jm_load_config", - "jm_save_config", - "jm_set_hostfile", - "jm_bootstrap_from", - "jm_bootstrap_list", - "jm_reset", - "jm_list_pipelines", - "jm_cd", - "jm_list_repos", - "jm_add_repo", - "jm_remove_repo", - "jm_promote_repo", - "jm_get_repo", - "jm_construct_pkg", - "jm_graph_show", - "jm_graph_build", - "jm_graph_modify" + "submit_slurm_job", + "check_job_status", + "cancel_slurm_job", + "list_slurm_jobs", + "get_slurm_info", + "get_job_details", + "get_job_output", + "get_queue_info", + "submit_array_job", + "get_node_info", + "allocate_slurm_nodes", + "deallocate_slurm_nodes", + "get_allocation_status" ], "stats": { "version": "1.0.0", - "updated": "2025-11-11" + "updated": "2026-02-19" }, "platforms": [ "claude", "cursor", "vscode" ], - "slug": "jarvis" + "slug": "slurm" } }; @@ -482,25 +482,20 @@ export const categories = { "color": "#3b82f6", "icon": "\ud83d\udcca" }, + "Utilities": { + "count": 1, + "color": "#ef4444", + "icon": "\ud83d\udd27" + }, "Analysis & Visualization": { - "count": 2, + "count": 3, "color": "#10b981", "icon": "\ud83d\udcc8" }, - "Scientific Visualization": { - "count": 1, - "color": "#8b5cf6", - "icon": "\ud83d\udd2c" - }, "System Management": { "count": 2, "color": "#f59e0b", "icon": "\ud83d\udda5\ufe0f" - }, - "Utilities": { - "count": 1, - "color": "#ef4444", - "icon": "\ud83d\udd27" } }; @@ -508,7 +503,7 @@ export const categories = { export const popularMcps = [ "jarvis", "hdf5", - "darshan", + "paraview", "pandas", "arxiv", "parallel_sort" @@ -518,7 +513,6 @@ export const popularMcps = [ export const categoryTypes = { "Data Processing": "data", "Analysis & Visualization": "analysis", - "Scientific Visualization": "scientific", "System Management": "system", "Utilities": "util" }; diff --git a/gemini-extension.json b/gemini-extension.json new file mode 100644 index 00000000..e41d7030 --- /dev/null +++ b/gemini-extension.json @@ -0,0 +1,118 @@ +{ + "name": "clio-kit", + "version": "1.0.0", + "mcpServers": { + "clio-adios": { + "command": "uvx", + "args": [ + "clio-kit", + "adios" + ] + }, + "clio-arxiv": { + "command": "uvx", + "args": [ + "clio-kit", + "arxiv" + ] + }, + "clio-chronolog": { + "command": "uvx", + "args": [ + "clio-kit", + "chronolog" + ] + }, + "clio-compression": { + "command": "uvx", + "args": [ + "clio-kit", + "compression" + ] + }, + "clio-darshan": { + "command": "uvx", + "args": [ + "clio-kit", + "darshan" + ] + }, + "clio-hdf5": { + "command": "uvx", + "args": [ + "clio-kit", + "hdf5" + ] + }, + "clio-jarvis": { + "command": "uvx", + "args": [ + "clio-kit", + "jarvis" + ] + }, + "clio-lmod": { + "command": "uvx", + "args": [ + "clio-kit", + "lmod" + ] + }, + "clio-ndp": { + "command": "uvx", + "args": [ + "clio-kit", + "ndp" + ] + }, + "clio-node-hardware": { + "command": "uvx", + "args": [ + "clio-kit", + "node-hardware" + ] + }, + "clio-pandas": { + "command": "uvx", + "args": [ + "clio-kit", + "pandas" + ] + }, + "clio-parallel-sort": { + "command": "uvx", + "args": [ + "clio-kit", + "parallel-sort" + ] + }, + "clio-paraview": { + "command": "uvx", + "args": [ + "clio-kit", + "paraview" + ] + }, + "clio-parquet": { + "command": "uvx", + "args": [ + "clio-kit", + "parquet" + ] + }, + "clio-plot": { + "command": "uvx", + "args": [ + "clio-kit", + "plot" + ] + }, + "clio-slurm": { + "command": "uvx", + "args": [ + "clio-kit", + "slurm" + ] + } + } +} diff --git a/scripts/extract_mcp_metadata.py b/scripts/extract_mcp_metadata.py new file mode 100644 index 00000000..bb9d5540 --- /dev/null +++ b/scripts/extract_mcp_metadata.py @@ -0,0 +1,108 @@ +#!/usr/bin/env python3 +"""Extract MCP server metadata via FastMCP 3.0 async API. + +Run from within a server directory: + cd clio-kit-mcp-servers/compression && uv run python ../../scripts/extract_mcp_metadata.py + +Outputs JSON to stdout with tools, resources, prompts, annotations, and tags. +""" + +import asyncio +import importlib +import json +import logging +import os +import sys +from pathlib import Path + +try: + import tomllib +except ImportError: + import tomli as tomllib + + +def find_server_module() -> str: + """Determine the server module name from pyproject.toml entry point.""" + pyproject_path = Path("pyproject.toml") + if not pyproject_path.exists(): + print("ERROR: No pyproject.toml found", file=sys.stderr) + sys.exit(1) + + with open(pyproject_path, "rb") as f: + data = tomllib.load(f) + + scripts = data.get("project", {}).get("scripts", {}) + if not scripts: + print("ERROR: No [project.scripts] found", file=sys.stderr) + sys.exit(1) + + entry_point = next(iter(scripts.values())) + return entry_point.split(":")[0] + + +async def extract(module_path: str) -> dict: + """Import the server and extract all metadata.""" + module = importlib.import_module(module_path) + mcp = getattr(module, "mcp") + + tools = await mcp.list_tools() + resources = await mcp.list_resources() + templates = await mcp.list_resource_templates() + prompts = await mcp.list_prompts() + + return { + "name": mcp.name, + "instructions": mcp.instructions or "", + "tools": [ + { + "name": t.name, + "description": t.description or "", + "annotations": t.annotations.model_dump() if t.annotations else {}, + "tags": sorted(t.tags) if hasattr(t, "tags") and t.tags else [], + } + for t in tools + ], + "resources": [ + { + "uri": str(r.uri), + "name": r.name, + "description": r.description or "", + } + for r in resources + ], + "resource_templates": [ + { + "uri_template": str(t.uri_template), + "name": t.name, + "description": t.description or "", + } + for t in templates + ], + "prompts": [ + { + "name": p.name, + "description": p.description or "", + } + for p in prompts + ], + } + + +def main() -> None: + # Suppress all logging and stray prints during import + logging.disable(logging.CRITICAL) + # Redirect stdout during import, then restore for JSON output + old_stdout = sys.stdout + sys.stdout = open(os.devnull, "w") + try: + module_path = find_server_module() + result = asyncio.run(extract(module_path)) + finally: + sys.stdout.close() + sys.stdout = old_stdout + logging.disable(logging.NOTSET) + print(json.dumps(result)) + + +if __name__ == "__main__": + main() diff --git a/scripts/generate_docs.py b/scripts/generate_docs.py index 3e901586..efcf9a97 100755 --- a/scripts/generate_docs.py +++ b/scripts/generate_docs.py @@ -6,7 +6,7 @@ import os import sys -import ast +import subprocess import re import json from pathlib import Path @@ -193,83 +193,34 @@ def _extract_description_from_readme(self, readme_content: str) -> Optional[str] return None def _extract_tools_from_server(self, mcp_dir: Path) -> List[Dict]: - """Extract tool information from server.py files.""" - server_files = list(mcp_dir.glob("src/**/server.py")) + """Extract tool information by importing the server via FastMCP 3.0 API.""" + script_dir = Path(__file__).parent + extract_script = script_dir / "extract_mcp_metadata.py" - tools = [] - for server_file in server_files: - try: - with open(server_file, "r", encoding="utf-8") as f: - content = f.read() - - tree = ast.parse(content) - - for node in ast.walk(tree): - if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)): - tool_info = self._extract_tool_from_function(node) - if tool_info: - tools.append(tool_info) - - except Exception as e: - print(f"Error parsing {server_file}: {e}") - - return tools - - def _extract_tool_from_function(self, node) -> Optional[Dict]: - """Extract tool information from a function node.""" - # Check for @mcp.tool decorator - for decorator in node.decorator_list: - if self._is_mcp_tool_decorator(decorator): - name = self._extract_decorator_name(decorator) or node.name - description = self._extract_decorator_description(decorator) - - # Get enhanced description from docstring - docstring = ast.get_docstring(node) - if docstring and not description: - description = docstring.split("\n")[0].strip() - - return { - "name": name, - "description": description or f"Tool: {name}", - "function_name": node.name, - } - - return None - - def _is_mcp_tool_decorator(self, decorator) -> bool: - """Check if decorator is @mcp.tool.""" - if isinstance(decorator, ast.Call): - if isinstance(decorator.func, ast.Attribute): - return ( - decorator.func.attr == "tool" - and isinstance(decorator.func.value, ast.Name) - and decorator.func.value.id == "mcp" - ) - elif isinstance(decorator, ast.Attribute): - return ( - decorator.attr == "tool" - and isinstance(decorator.value, ast.Name) - and decorator.value.id == "mcp" + try: + result = subprocess.run( + ["uv", "run", "python", str(extract_script)], + cwd=str(mcp_dir), + capture_output=True, + text=True, + timeout=30, ) - return False - - def _extract_decorator_name(self, decorator) -> Optional[str]: - """Extract name from decorator arguments.""" - if isinstance(decorator, ast.Call): - for keyword in decorator.keywords: - if keyword.arg == "name" and isinstance(keyword.value, ast.Constant): - return keyword.value.value - return None - - def _extract_decorator_description(self, decorator) -> Optional[str]: - """Extract description from decorator arguments.""" - if isinstance(decorator, ast.Call): - for keyword in decorator.keywords: - if keyword.arg == "description" and isinstance( - keyword.value, ast.Constant - ): - return keyword.value.value - return None + if result.returncode != 0: + print(f"Warning: metadata extraction failed for {mcp_dir.name}: {result.stderr.strip()}") + return [] + + metadata = json.loads(result.stdout) + return [ + { + "name": tool["name"], + "description": tool.get("description", f"Tool: {tool['name']}"), + "function_name": tool["name"], + } + for tool in metadata.get("tools", []) + ] + except (subprocess.TimeoutExpired, json.JSONDecodeError, FileNotFoundError) as e: + print(f"Warning: could not extract metadata for {mcp_dir.name}: {e}") + return [] class DocusaurusGenerator: diff --git a/scripts/generate_server_json.py b/scripts/generate_server_json.py new file mode 100644 index 00000000..955cd6e1 --- /dev/null +++ b/scripts/generate_server_json.py @@ -0,0 +1,318 @@ +#!/usr/bin/env python3 +"""Generate publishing manifests for MCP registries and client integrations. + +Iterates each server in clio-kit-mcp-servers/, extracts live FastMCP metadata via +extract_mcp_metadata.py, reads pyproject.toml for version/description, and writes: + - clio-kit-mcp-servers/{name}/server.json (MCP registry manifest) + - clio-kit-mcp-servers/{name}/.claude-plugin/plugin.json (Claude Code plugin) + - clio-kit-mcp-servers/{name}/.mcp.json (Claude Code MCP config) + - .claude-plugin/marketplace.json (Claude Code marketplace) + - claude_desktop_config.json (Claude Desktop config) + - gemini-extension.json (Gemini CLI extension) + +Usage: + python scripts/generate_server_json.py [clio-kit-mcp-servers] +""" + +import json +import subprocess +import sys +from pathlib import Path +from typing import Any + +try: + import tomllib +except ImportError: + import tomli as tomllib # type: ignore[no-redef] + +REPO_URL = "https://github.com/iowarp/clio-kit" + +# Domain-specific tags for each server +SERVER_TAGS: dict[str, list[str]] = { + "adios": ["scientific-computing", "adios2", "bp5", "data-io", "hpc"], + "arxiv": ["research", "arxiv", "papers", "literature-search"], + "chronolog": ["logging", "distributed-systems", "hpc", "time-series"], + "compression": ["compression", "gzip", "file-operations", "data-management"], + "darshan": ["io-profiling", "performance-analysis", "hpc", "darshan"], + "hdf5": ["scientific-computing", "hdf5", "data-analysis", "hierarchical-data"], + "jarvis": ["pipeline-management", "hpc", "workflow-automation"], + "lmod": ["environment-modules", "hpc", "lmod", "system-administration"], + "ndp": ["datasets", "ckan", "national-data-platform", "data-discovery"], + "node-hardware": ["hardware-monitoring", "system-info", "performance"], + "pandas": ["data-analysis", "pandas", "dataframes", "statistics"], + "parallel-sort": ["log-processing", "sorting", "large-files", "hpc"], + "paraview": ["scientific-visualization", "paraview", "3d-rendering", "hpc"], + "parquet": ["parquet", "apache-arrow", "columnar-data", "data-analysis"], + "plot": ["data-visualization", "matplotlib", "plotting", "charts"], + "slurm": ["hpc", "slurm", "job-scheduling", "cluster-management"], +} + + +def read_pyproject(server_dir: Path) -> dict[str, Any]: + """Read pyproject.toml and return the [project] table.""" + pyproject_path = server_dir / "pyproject.toml" + with open(pyproject_path, "rb") as f: + data = tomllib.load(f) + return data.get("project", {}) + + +def extract_metadata(server_dir: Path) -> dict[str, Any] | None: + """Run extract_mcp_metadata.py in the server's environment.""" + script_path = Path(__file__).parent / "extract_mcp_metadata.py" + try: + result = subprocess.run( + ["uv", "run", "python", str(script_path)], + cwd=str(server_dir), + capture_output=True, + text=True, + timeout=60, + ) + if result.returncode != 0: + print( + f" Warning: metadata extraction failed: {result.stderr.strip()[:200]}" + ) + return None + return json.loads(result.stdout) + except (subprocess.TimeoutExpired, json.JSONDecodeError, FileNotFoundError) as e: + print(f" Warning: could not extract metadata: {e}") + return None + + +def _write_json(path: Path, data: dict[str, Any]) -> None: + """Write a dict as formatted JSON to a file, creating parent dirs.""" + path.parent.mkdir(parents=True, exist_ok=True) + with open(path, "w", encoding="utf-8") as f: + json.dump(data, f, indent=2) + f.write("\n") + + +# --- MCP Registry (server.json) --- + + +def build_server_json( + server_name: str, + project: dict[str, Any], + metadata: dict[str, Any], +) -> dict[str, Any]: + """Build the server.json manifest for the official MCP registry.""" + version = project.get("version", "1.0.0") + description = project.get("description", "") + + tools = [ + {"name": t["name"], "description": t["description"]} + for t in metadata.get("tools", []) + ] + resources = [ + {"uri": r["uri"], "name": r["name"], "description": r["description"]} + for r in metadata.get("resources", []) + ] + resource_templates = [ + { + "uri_template": t["uri_template"], + "name": t["name"], + "description": t["description"], + } + for t in metadata.get("resource_templates", []) + ] + prompts = [ + {"name": p["name"], "description": p["description"]} + for p in metadata.get("prompts", []) + ] + + server_json: dict[str, Any] = { + "name": f"io.github.iowarp/{server_name}-mcp", + "description": description, + "version": version, + "repository": REPO_URL, + "package": { + "registry_name": "pypi", + "name": "clio-kit", + "command_arguments": ["clio-kit", server_name], + }, + "tools": tools, + } + + if resources: + server_json["resources"] = resources + if resource_templates: + server_json["resource_templates"] = resource_templates + if prompts: + server_json["prompts"] = prompts + + server_json["tags"] = SERVER_TAGS.get(server_name, []) + return server_json + + +# --- Claude Code Plugin Marketplace --- + + +def write_claude_plugin_files( + server_dir: Path, + server_name: str, + project: dict[str, Any], +) -> None: + """Write .claude-plugin/plugin.json and .mcp.json for a server.""" + description = project.get("description", "") + version = project.get("version", "1.0.0") + + plugin_json = { + "name": f"clio-{server_name}", + "description": description, + "version": version, + } + _write_json(server_dir / ".claude-plugin" / "plugin.json", plugin_json) + + mcp_json = { + f"clio-{server_name}": { + "command": "uvx", + "args": ["clio-kit", server_name], + } + } + _write_json(server_dir / ".mcp.json", mcp_json) + + +def build_marketplace_json( + server_entries: list[dict[str, Any]], +) -> dict[str, Any]: + """Build the .claude-plugin/marketplace.json for the repo root.""" + return { + "name": "clio-kit", + "owner": { + "name": "IoWarp Team - Gnosis Research Center", + "email": "grc@illinoistech.edu", + }, + "metadata": { + "description": "CLIO Kit - MCP Servers for Scientific Computing and HPC", + "version": "1.0.0", + "pluginRoot": "./clio-kit-mcp-servers", + }, + "plugins": server_entries, + } + + +# --- Claude Desktop Config --- + + +def build_claude_desktop_config(server_names: list[str]) -> dict[str, Any]: + """Build a master claude_desktop_config.json with all servers.""" + servers: dict[str, Any] = {} + for name in sorted(server_names): + servers[f"clio-{name}"] = { + "command": "uvx", + "args": ["clio-kit", name], + } + return {"mcpServers": servers} + + +# --- Gemini CLI Extension --- + + +def build_gemini_extension(server_names: list[str]) -> dict[str, Any]: + """Build gemini-extension.json bundling all servers.""" + mcp_servers: dict[str, Any] = {} + for name in sorted(server_names): + mcp_servers[f"clio-{name}"] = { + "command": "uvx", + "args": ["clio-kit", name], + } + return { + "name": "clio-kit", + "version": "1.0.0", + "mcpServers": mcp_servers, + } + + +# --- Main Generation --- + + +def generate_all(mcps_dir: str) -> None: + """Generate all publishing manifests.""" + mcps_path = Path(mcps_dir) + if not mcps_path.exists(): + print(f"Error: {mcps_dir} does not exist") + sys.exit(1) + + repo_root = mcps_path.parent + generated: list[str] = [] + failed: list[str] = [] + marketplace_plugins: list[dict[str, Any]] = [] + + for server_dir in sorted(mcps_path.iterdir()): + if not server_dir.is_dir() or server_dir.name.startswith("."): + continue + + pyproject_file = server_dir / "pyproject.toml" + if not pyproject_file.exists(): + continue + + server_name = server_dir.name + print(f"Processing {server_name}...") + + project = read_pyproject(server_dir) + + # server.json: only update if metadata extraction succeeds + metadata = extract_metadata(server_dir) + if metadata is not None: + server_json = build_server_json(server_name, project, metadata) + _write_json(server_dir / "server.json", server_json) + tool_count = len(server_json.get("tools", [])) + print(f" Wrote server.json ({tool_count} tools)") + elif not (server_dir / "server.json").exists(): + print(" Warning: no metadata and no existing server.json") + failed.append(server_name) + continue + else: + print(" Skipped server.json (using existing, extraction failed)") + + # Claude Code plugin files: always write (no metadata needed) + write_claude_plugin_files(server_dir, server_name, project) + print(" Wrote .claude-plugin/plugin.json + .mcp.json") + + # Collect marketplace entry + description = project.get("description", "") + version = project.get("version", "1.0.0") + marketplace_plugins.append( + { + "name": f"clio-{server_name}", + "source": f"./clio-kit-mcp-servers/{server_name}", + "description": description, + "version": version, + "category": "development", + "keywords": SERVER_TAGS.get(server_name, []), + "license": "BSD-3-Clause", + "repository": REPO_URL, + } + ) + + generated.append(server_name) + + # Claude Code marketplace manifest + marketplace = build_marketplace_json(marketplace_plugins) + _write_json(repo_root / ".claude-plugin" / "marketplace.json", marketplace) + print( + f"\nWrote .claude-plugin/marketplace.json ({len(marketplace_plugins)} plugins)" + ) + + # Claude Desktop master config + claude_config = build_claude_desktop_config(generated) + _write_json(repo_root / "claude_desktop_config.json", claude_config) + print(f"Wrote claude_desktop_config.json ({len(generated)} servers)") + + # Gemini CLI extension manifest + gemini_ext = build_gemini_extension(generated) + _write_json(repo_root / "gemini-extension.json", gemini_ext) + print(f"Wrote gemini-extension.json ({len(generated)} servers)") + + # Summary + print(f"\nGenerated: {len(generated)} servers") + if failed: + print(f"Failed: {len(failed)} servers: {', '.join(failed)}") + + +def main() -> None: + mcps_dir = sys.argv[1] if len(sys.argv) > 1 else "clio-kit-mcp-servers" + generate_all(mcps_dir) + + +if __name__ == "__main__": + main() diff --git a/scripts/readme_filler.py b/scripts/readme_filler.py index 552e34e5..939ab06b 100644 --- a/scripts/readme_filler.py +++ b/scripts/readme_filler.py @@ -1,470 +1,231 @@ #!/usr/bin/env python3 -""" -Script to automatically update README files for all MCP servers in the mcps/ directory. -Parses docstrings from server.py files and updates the Capabilities section in README.md files. +"""Update README files for all MCP servers using FastMCP 3.0 metadata. + +Imports each server via extract_mcp_metadata.py and updates the Capabilities, +Claude Code, Claude Desktop, and Gemini CLI sections in each server's README.md. + +Usage: + python scripts/readme_filler.py clio-kit-mcp-servers """ -import os -import sys -import ast +import json import re -import glob -from typing import Dict, List, Tuple, Optional +import subprocess +import sys from pathlib import Path +from typing import Any -class DocstringParser: - """Parse docstrings from Python AST to extract function information.""" - - def __init__(self): - self.tools = [] - self.resources = [] - self.prompts = [] - - def parse_server_file(self, file_path: str) -> Dict[str, List[Dict]]: - """Parse a server.py file and extract tool, resource, and prompt information.""" - try: - with open(file_path, 'r', encoding='utf-8') as f: - content = f.read() - - tree = ast.parse(content) - - tools = [] - resources = [] - prompts = [] - - for node in ast.walk(tree): - if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)): - # Check for @mcp.tool decorator - tool_info = self._extract_tool_info(node) - if tool_info: - tools.append(tool_info) - - # Check for @mcp.resource decorator - resource_info = self._extract_resource_info(node) - if resource_info: - resources.append(resource_info) - - # Check for @mcp.prompt decorator - prompt_info = self._extract_prompt_info(node) - if prompt_info: - prompts.append(prompt_info) - - return { - 'tools': tools, - 'resources': resources, - 'prompts': prompts - } - - except Exception as e: - print(f"Error parsing {file_path}: {e}") - return {'tools': [], 'resources': [], 'prompts': []} - - def _extract_tool_info(self, node) -> Optional[Dict]: - """Extract tool information from a function with @mcp.tool decorator.""" - for decorator in node.decorator_list: - if self._is_mcp_decorator(decorator, 'tool'): - return self._parse_function_details(node, decorator) - return None - - def _extract_resource_info(self, node) -> Optional[Dict]: - """Extract resource information from a function with @mcp.resource decorator.""" - for decorator in node.decorator_list: - if self._is_mcp_decorator(decorator, 'resource'): - return self._parse_function_details(node, decorator) - return None - - def _extract_prompt_info(self, node) -> Optional[Dict]: - """Extract prompt information from a function with @mcp.prompt decorator.""" - for decorator in node.decorator_list: - if self._is_mcp_decorator(decorator, 'prompt'): - return self._parse_function_details(node, decorator) - return None - - def _is_mcp_decorator(self, decorator, decorator_type: str) -> bool: - """Check if decorator is an MCP decorator of the specified type.""" - if isinstance(decorator, ast.Call): - if isinstance(decorator.func, ast.Attribute): - return (decorator.func.attr == decorator_type and - isinstance(decorator.func.value, ast.Name) and - decorator.func.value.id == 'mcp') - elif isinstance(decorator, ast.Attribute): - # Handle case like @mcp.tool without parentheses - return (decorator.attr == decorator_type and - isinstance(decorator.value, ast.Name) and - decorator.value.id == 'mcp') - return False - - def _parse_function_details(self, node, decorator) -> Dict: - """Parse function details including name, description, parameters, and returns.""" - # Extract name from decorator - name = self._extract_decorator_name(decorator) - if not name: - name = node.name.replace('_tool', '').replace('_handler', '') - - # Extract description from decorator - description = self._extract_decorator_description(decorator) - - # Extract enhanced description from docstring - enhanced_description = self._extract_enhanced_description_from_docstring(node) - - # Use enhanced description if available, otherwise use decorator description - final_description = enhanced_description or description or "No description available" - - # Extract parameters and returns from docstring and function signature - params, returns = self._parse_docstring_params_and_returns(node) - - # If no parameters from docstring, extract from function signature - if not params: - params = self._extract_function_signature_params(node) - - # If no returns from docstring, extract from function signature - if not returns: - returns = self._extract_function_return_type(node) - - return { - 'name': name, - 'description': final_description, - 'parameters': params, - 'returns': returns - } - - def _extract_decorator_name(self, decorator) -> Optional[str]: - """Extract name from decorator arguments.""" - if isinstance(decorator, ast.Call): - for keyword in decorator.keywords: - if keyword.arg == 'name' and isinstance(keyword.value, ast.Constant): - return keyword.value.value - return None - - def _extract_decorator_description(self, decorator) -> Optional[str]: - """Extract description from decorator arguments.""" - if isinstance(decorator, ast.Call): - for keyword in decorator.keywords: - if keyword.arg == 'description' and isinstance(keyword.value, ast.Constant): - return keyword.value.value - return None - - def _extract_enhanced_description_from_docstring(self, node) -> Optional[str]: - """Extract enhanced description from function docstring (first line or summary).""" - if not node.args or not ast.get_docstring(node): - return None - - docstring = ast.get_docstring(node) - if not docstring: +def extract_metadata(mcp_dir: Path) -> dict[str, Any] | None: + """Extract metadata from an MCP server by running it in its own venv.""" + script_path = Path(__file__).parent / "extract_mcp_metadata.py" + try: + result = subprocess.run( + ["uv", "run", "python", str(script_path)], + cwd=str(mcp_dir), + capture_output=True, + text=True, + timeout=30, + ) + if result.returncode != 0: + print(f" Warning: extraction failed: {result.stderr.strip()[:200]}") return None - - # Look for a description in the docstring - usually the first paragraph - lines = docstring.strip().split('\n') - description_lines = [] - - for line in lines: - line = line.strip() - if not line: - break # Stop at first empty line - if line.startswith('Args:') or line.startswith('Parameters:') or line.startswith('Returns:'): - break # Stop at parameters section - description_lines.append(line) - - if description_lines: - return ' '.join(description_lines) - + return json.loads(result.stdout) + except (subprocess.TimeoutExpired, json.JSONDecodeError, FileNotFoundError) as e: + print(f" Warning: could not extract metadata: {e}") return None - - def _parse_docstring_params_and_returns(self, node) -> Tuple[List[Dict], str]: - """Parse parameters and returns from function docstring.""" - docstring = ast.get_docstring(node) - if not docstring: - return [], "" - - params = [] - returns = "" - - lines = docstring.split('\n') - current_section = None - current_param = None - - for line in lines: - line = line.strip() - - # Detect sections - if line.startswith('Args:') or line.startswith('Parameters:'): - current_section = 'params' - continue - elif line.startswith('Returns:'): - current_section = 'returns' - continue - elif line.startswith('Raises:') or line.startswith('Note:') or line.startswith('Example:'): - current_section = None - continue - - if current_section == 'params' and line: - # Parse parameter line like "param_name (type): description" - param_match = re.match(r'(\w+)\s*\(([^)]+)\):\s*(.+)', line) - if param_match: - param_name, param_type, param_desc = param_match.groups() - - # Check if optional - optional = 'optional' in param_desc.lower() or 'none' in param_type.lower() - - params.append({ - 'name': param_name, - 'type': param_type, - 'description': param_desc, - 'optional': optional - }) - current_param = params[-1] - elif current_param and line.startswith('-') or line.startswith(' '): - # Continuation of previous parameter description - current_param['description'] += ' ' + line.lstrip('- ') - - elif current_section == 'returns' and line: - returns += line + ' ' - - return params, returns.strip() - - def _extract_function_signature_params(self, node) -> List[Dict]: - """Extract parameters from function signature.""" - params = [] - - # Skip 'self' parameter if present - args = node.args.args - if args and args[0].arg in ['self', 'cls']: - args = args[1:] - - # Get default values - defaults = node.args.defaults - num_defaults = len(defaults) - num_args = len(args) - - for i, arg in enumerate(args): - param_name = arg.arg - - # Determine if parameter has a default (is optional) - has_default = i >= (num_args - num_defaults) - - # Extract type annotation if available - param_type = "Any" - if arg.annotation: - if isinstance(arg.annotation, ast.Name): - param_type = arg.annotation.id - elif isinstance(arg.annotation, ast.Constant): - param_type = str(arg.annotation.value) - elif hasattr(arg.annotation, 'id'): - param_type = arg.annotation.id - else: - param_type = "Any" - - # Get default value if available - default_value = None - if has_default: - default_idx = i - (num_args - num_defaults) - default_node = defaults[default_idx] - if isinstance(default_node, ast.Constant): - default_value = default_node.value - elif isinstance(default_node, ast.Name) and default_node.id == 'None': - default_value = None - else: - default_value = "..." - - # Create parameter description - description = f"Parameter for {param_name}" - if default_value is not None: - description += f" (default: {default_value})" - - params.append({ - 'name': param_name, - 'type': param_type, - 'description': description, - 'optional': has_default - }) - - return params - - def _extract_function_return_type(self, node) -> str: - """Extract return type from function signature.""" - if node.returns: - if isinstance(node.returns, ast.Name): - return f"Returns {node.returns.id}" - elif isinstance(node.returns, ast.Constant): - return f"Returns {node.returns.value}" - else: - return "Returns data" - return "Returns data" -class ReadmeUpdater: - """Update README files with capabilities extracted from server.py files.""" - - def __init__(self): - self.parser = DocstringParser() - - def update_all_mcps(self, mcps_dir: str): - """Update README files for all MCP servers in the directory.""" - mcps_path = Path(mcps_dir) - - if not mcps_path.exists(): - raise FileNotFoundError(f"Directory {mcps_dir} does not exist") - - for mcp_dir in mcps_path.iterdir(): - if mcp_dir.is_dir(): - print(f"Processing MCP server: {mcp_dir.name}") - try: - self.update_mcp_readme(mcp_dir) - except Exception as e: - print(f"Error processing {mcp_dir.name}: {e}") - - def update_mcp_readme(self, mcp_dir: Path): - """Update README file for a single MCP server.""" - # Find server.py file - server_file = self._find_server_file(mcp_dir) - if not server_file: - raise FileNotFoundError(f"No server.py file found in src/ folder for {mcp_dir.name}. Server file must be located in src/ directory.") - - # Parse capabilities - capabilities = self.parser.parse_server_file(str(server_file)) - - # Find README file - readme_file = mcp_dir / "README.md" - if not readme_file.exists(): - print(f"Warning: README.md not found in {mcp_dir}, skipping") - return - - # Update README - self._update_readme_content(readme_file, capabilities) - print(f"Updated README for {mcp_dir.name}") - - def _find_server_file(self, mcp_dir: Path) -> Optional[Path]: - """Find the server.py file in the MCP directory. Must be inside src/ folder.""" - # Only look for server.py files inside src/ directory - patterns = [ - "src/server.py", - "src/*/server.py" - ] - - for pattern in patterns: - matches = list(mcp_dir.glob(pattern)) - if matches: - # Verify that the found file is actually in a src/ directory - server_file = matches[0] - if "src" in server_file.parts: - return server_file - - return None - - def _update_readme_content(self, readme_file: Path, capabilities: Dict): - """Update the README file content with new capabilities.""" - with open(readme_file, 'r', encoding='utf-8') as f: - content = f.read() - - # Generate new capabilities section - new_capabilities_section = self._generate_capabilities_section(capabilities) - - # Find and replace the capabilities section - updated_content = self._replace_capabilities_section(content, new_capabilities_section) - - # Write back to file - with open(readme_file, 'w', encoding='utf-8') as f: - f.write(updated_content) - - def _generate_capabilities_section(self, capabilities: Dict) -> str: - """Generate the capabilities section content.""" - sections = [] - - # Add tools section - if capabilities['tools']: - sections.append("## Capabilities\n") - for tool in capabilities['tools']: - sections.append(self._format_capability_entry(tool)) - - # Add resources section - if capabilities['resources']: - if not sections: - sections.append("## Capabilities\n") - sections.append("### Resources\n") - for resource in capabilities['resources']: - sections.append(self._format_capability_entry(resource)) - - # Add prompts section - if capabilities['prompts']: - if not sections: - sections.append("## Capabilities\n") - sections.append("### Prompts\n") - for prompt in capabilities['prompts']: - sections.append(self._format_capability_entry(prompt)) - - return '\n'.join(sections) - - def _format_capability_entry(self, capability: Dict) -> str: - """Format a single capability entry following the Arxiv example.""" - lines = [] - - # Function name header - lines.append(f"### `{capability['name']}`") - - # Description - lines.append(f"**Description**: {capability['description']}") - lines.append("") - - # Parameters - if capability['parameters']: - lines.append("**Parameters**:") - for param in capability['parameters']: - optional_text = ", optional" if param.get('optional') else "" - lines.append(f"- `{param['name']}` ({param['type']}{optional_text}): {param['description']}") - lines.append("") - - # Returns - if capability['returns']: - lines.append(f"**Returns**: {capability['returns']}") +def format_capabilities_section(metadata: dict[str, Any]) -> str: + """Generate the ## Capabilities markdown section from metadata.""" + lines: list[str] = ["## Capabilities\n"] + + # Tools + tools = metadata.get("tools", []) + if tools: + for tool in tools: + lines.append(f"### `{tool['name']}`") + lines.append(f"**Description**: {tool['description']}") + annotations = tool.get("annotations", {}) + hints = [] + if annotations.get("readOnlyHint"): + hints.append("read-only") + if annotations.get("destructiveHint"): + hints.append("destructive") + if annotations.get("idempotentHint"): + hints.append("idempotent") + if hints: + lines.append(f"**Hints**: {', '.join(hints)}") + tags = tool.get("tags", []) + if tags: + lines.append(f"**Tags**: {', '.join(tags)}") lines.append("") - - return '\n'.join(lines) - - def _replace_capabilities_section(self, content: str, new_section: str) -> str: - """Replace the capabilities section in the README content while preserving everything else.""" - # Pattern to match from ## Capabilities to the next ## section or end of file - pattern = r'## Capabilities.*?(?=\n## |\Z)' - - if re.search(pattern, content, re.DOTALL): - # Replace existing capabilities section, preserving the rest - return re.sub(pattern, new_section.rstrip(), content, flags=re.DOTALL) - else: - # If no capabilities section exists, try to insert before ## Examples - examples_match = re.search(r'\n(## Examples)', content) - if examples_match: - # Insert before Examples section - before_examples = content[:examples_match.start(1)] - examples_and_after = content[examples_match.start(1):] - return f"{before_examples}\n{new_section}\n\n{examples_and_after}" - else: - # Look for any other ## section to insert before - section_match = re.search(r'\n(## [^C])', content) # Any section not starting with 'C' to avoid Capabilities - if section_match: - before_section = content[:section_match.start(1)] - section_and_after = content[section_match.start(1):] - return f"{before_section}\n{new_section}\n\n{section_and_after}" - else: - # If no other sections, append at the end - return content.rstrip() + f"\n\n{new_section}" + # Resources + resources = metadata.get("resources", []) + templates = metadata.get("resource_templates", []) + if resources or templates: + lines.append("### Resources\n") + for r in resources: + lines.append(f"- `{r['uri']}` - {r['description']}") + for t in templates: + lines.append(f"- `{t['uri_template']}` - {t['description']}") + lines.append("") -def main(): - """Main entry point.""" - if len(sys.argv) != 2: - print("Usage: python update_readme_capabilities.py ") + # Prompts + prompts = metadata.get("prompts", []) + if prompts: + lines.append("### Prompts\n") + for p in prompts: + lines.append(f"- **{p['name']}**: {p['description']}") + lines.append("") + + return "\n".join(lines) + + +def format_claude_desktop_section(server_name: str) -> str: + """Generate the ## Claude Desktop markdown section for a server.""" + config = json.dumps( + { + "mcpServers": { + f"clio-{server_name}": { + "command": "uvx", + "args": ["clio-kit", server_name], + } + } + }, + indent=2, + ) + lines = [ + "## Claude Desktop\n", + "Add to your Claude Desktop config (`claude_desktop_config.json`):\n", + "```json", + config, + "```", + "", + ] + return "\n".join(lines) + + +def format_claude_code_section(server_name: str) -> str: + """Generate the ## Claude Code markdown section for a server.""" + lines = [ + "## Claude Code\n", + "```bash", + f"claude mcp add clio-{server_name} -- uvx clio-kit {server_name}", + "```\n", + "Or install via the CLIO Kit plugin marketplace:\n", + "```", + "/plugin marketplace add iowarp/clio-kit", + f"/plugin install clio-{server_name}@iowarp-clio-kit", + "```", + "", + ] + return "\n".join(lines) + + +def format_gemini_section(server_name: str) -> str: + """Generate the ## Gemini CLI markdown section for a server.""" + config = json.dumps( + { + "mcpServers": { + f"clio-{server_name}": { + "command": "uvx", + "args": ["clio-kit", server_name], + } + } + }, + indent=2, + ) + lines = [ + "## Gemini CLI\n", + "Add to `~/.gemini/settings.json`:\n", + "```json", + config, + "```\n", + "Or install the CLIO Kit extension:\n", + "```bash", + "gemini extensions install https://github.com/iowarp/clio-kit", + "```", + "", + ] + return "\n".join(lines) + + +def update_section(content: str, heading: str, new_section: str) -> str: + """Replace a ## heading section in content, or append before ## Examples / EOF.""" + pattern = rf"## {re.escape(heading)}.*?(?=\n## |\Z)" + if re.search(pattern, content, re.DOTALL): + return re.sub(pattern, new_section.rstrip(), content, flags=re.DOTALL) + # No existing section — append before ## Examples or at end + examples_match = re.search(r"\n(## Examples)", content) + if examples_match: + pos = examples_match.start(1) + return content[:pos] + "\n" + new_section + "\n\n" + content[pos:] + return content.rstrip() + "\n\n" + new_section + + +def update_readme( + readme_file: Path, + capabilities_section: str, + claude_code_section: str, + claude_desktop_section: str, + gemini_section: str, +) -> None: + """Replace Capabilities, Claude Code, Claude Desktop, and Gemini sections.""" + content = readme_file.read_text(encoding="utf-8") + content = update_section(content, "Capabilities", capabilities_section) + content = update_section(content, "Claude Code", claude_code_section) + content = update_section(content, "Claude Desktop", claude_desktop_section) + content = update_section(content, "Gemini CLI", gemini_section) + readme_file.write_text(content, encoding="utf-8") + + +def update_all_mcps(mcps_dir: str) -> None: + """Update README files for all MCP servers.""" + mcps_path = Path(mcps_dir) + if not mcps_path.exists(): + print(f"Error: {mcps_dir} does not exist") sys.exit(1) - - mcps_dir = sys.argv[1] - - try: - updater = ReadmeUpdater() - updater.update_all_mcps(mcps_dir) - print("Successfully updated all README files!") - except Exception as e: - print(f"Error: {e}") + + for mcp_dir in sorted(mcps_path.iterdir()): + if not mcp_dir.is_dir() or mcp_dir.name.startswith("."): + continue + + pyproject = mcp_dir / "pyproject.toml" + readme = mcp_dir / "README.md" + if not pyproject.exists(): + continue + if not readme.exists(): + print(f" Skipping {mcp_dir.name}: no README.md") + continue + + server_name = mcp_dir.name + print(f"Processing {server_name}...") + metadata = extract_metadata(mcp_dir) + if metadata is None: + continue + + capabilities = format_capabilities_section(metadata) + claude_code = format_claude_code_section(server_name) + claude_desktop = format_claude_desktop_section(server_name) + gemini = format_gemini_section(server_name) + update_readme(readme, capabilities, claude_code, claude_desktop, gemini) + tool_count = len(metadata.get("tools", [])) + print( + f" Updated README ({tool_count} tools, " + f"{len(metadata.get('resources', [])) + len(metadata.get('resource_templates', []))} resources, " + f"{len(metadata.get('prompts', []))} prompts)" + ) + + +def main() -> None: + if len(sys.argv) != 2: + print("Usage: python readme_filler.py ") sys.exit(1) + update_all_mcps(sys.argv[1]) + print("Done.") if __name__ == "__main__": - main() \ No newline at end of file + main() diff --git a/scripts/validate_fastmcp.py b/scripts/validate_fastmcp.py new file mode 100644 index 00000000..c3852131 --- /dev/null +++ b/scripts/validate_fastmcp.py @@ -0,0 +1,113 @@ +#!/usr/bin/env python3 +"""Validate that an MCP server meets FastMCP 3.0 compliance requirements. + +Run from within a server directory: + cd clio-kit-mcp-servers/compression && uv run python ../../scripts/validate_fastmcp.py + +Checks: +- instructions set on FastMCP constructor +- All tools have annotations (readOnlyHint, destructiveHint, idempotentHint) +- All tools have tags +- At least 1 resource registered +- At least 1 prompt registered +""" + +import asyncio +import importlib +import json +import sys +from pathlib import Path + +try: + import tomllib +except ImportError: + import tomli as tomllib + + +def find_server_module() -> str: + """Determine the server module name from pyproject.toml entry point.""" + pyproject_path = Path("pyproject.toml") + if not pyproject_path.exists(): + print("ERROR: No pyproject.toml found in current directory") + sys.exit(1) + + with open(pyproject_path, "rb") as f: + data = tomllib.load(f) + + scripts = data.get("project", {}).get("scripts", {}) + if not scripts: + print("ERROR: No [project.scripts] entry found in pyproject.toml") + sys.exit(1) + + # Entry point format: "module.path:function" + entry_point = next(iter(scripts.values())) + module_path = entry_point.split(":")[0] + return module_path + + +async def validate(module_path: str) -> list[str]: + """Import the server module and validate FastMCP 3.0 compliance.""" + errors: list[str] = [] + + try: + module = importlib.import_module(module_path) + except ImportError as e: + errors.append(f"Cannot import {module_path}: {e}") + return errors + + mcp = getattr(module, "mcp", None) + if mcp is None: + errors.append(f"No 'mcp' FastMCP instance found in {module_path}") + return errors + + # Check instructions + if not mcp.instructions: + errors.append("Missing: instructions not set on FastMCP constructor") + + # Check tools + tools = await mcp.list_tools() + if not tools: + errors.append("Missing: no tools registered") + else: + for tool in tools: + if not tool.annotations: + errors.append(f"Tool '{tool.name}': missing annotations") + else: + ann = tool.annotations.model_dump() + for hint in ("readOnlyHint", "destructiveHint", "idempotentHint"): + if ann.get(hint) is None: + errors.append(f"Tool '{tool.name}': annotation '{hint}' not set") + + if not hasattr(tool, "tags") or not tool.tags: + errors.append(f"Tool '{tool.name}': missing tags") + + # Check resources (static or templates) + resources = await mcp.list_resources() + templates = await mcp.list_resource_templates() + if not resources and not templates: + errors.append("Missing: no resources registered (need >= 1)") + + # Check prompts + prompts = await mcp.list_prompts() + if not prompts: + errors.append("Missing: no prompts registered (need >= 1)") + + return errors + + +def main() -> None: + module_path = find_server_module() + errors = asyncio.run(validate(module_path)) + + server_name = Path.cwd().name + if errors: + print(f"FAIL: {server_name} ({len(errors)} issues)") + for error in errors: + print(f" - {error}") + sys.exit(1) + else: + print(f"PASS: {server_name} (FastMCP 3.0 compliant)") + + +if __name__ == "__main__": + main()