foo-mcp 0.1.0__tar.gz

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

@@ -0,0 +1,15 @@
+{
+  "name": "foo-mcp",
+  "description": "Single-plugin marketplace for the FOO MCP server — multiagent orchestration with hash-chained tracing.",
+  "owner": {
+    "name": "David Pletta",
+    "url": "https://github.com/dpletta"
+  },
+  "plugins": [
+    {
+      "name": "foo-mcp",
+      "source": "./",
+      "description": "Transparent multiagent orchestration as a Model Context Protocol server."
+    }
+  ]
+}

foo_mcp-0.1.0/.claude-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "foo-mcp",
+  "displayName": "FOO MCP Server",
+  "description": "Transparent multiagent orchestration with hash-chained tracing \u2014 peer critique, harmonizer judgment, and target-agent reflection across OpenAI, Anthropic, Gemini, Hugging Face, and Apple Silicon MLX providers.",
+  "version": "0.1.0",
+  "author": {
+    "name": "David Pletta",
+    "url": "https://github.com/dpletta"
+  },
+  "homepage": "https://github.com/dpletta/foo-mcp",
+  "repository": "https://github.com/dpletta/foo-mcp",
+  "license": "MIT",
+  "mcpServers": {
+    "foo-mcp": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "${CLAUDE_PLUGIN_ROOT}",
+        "foo-mcp"
+      ],
+      "env": {
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
+        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
+        "GEMINI_API_KEY": "${GEMINI_API_KEY}",
+        "GOOGLE_API_KEY": "${GOOGLE_API_KEY}",
+        "HF_TOKEN": "${HF_TOKEN}",
+        "HUGGINGFACE_API_KEY": "${HUGGINGFACE_API_KEY}",
+        "FOO_MCP_CONFIG": "${CLAUDE_PLUGIN_ROOT}/config/foo.agents.example.json"
+      }
+    }
+  }
+}

foo_mcp-0.1.0/.env.example

@@ -0,0 +1,27 @@
+# Copy to .env for local development. Do not commit real keys.
+#
+# IMPORTANT: do NOT wrap values in quotes. Use KEY=sk-... not KEY="sk-...".
+# Surrounding quotes are passed through to provider SDKs and cause silent 401s.
+# foo-mcp strips matched wrapping quotes defensively, but other tooling may not.
+# Optional: override the bundled example with your own agents config.
+# Default is the example shipped inside the installed package.
+# FOO_MCP_CONFIG=/absolute/path/to/my-agents.json
+FOO_MCP_RUNS_DIR=runs
+FOO_MCP_TRACE_INCLUDE_RAW_CONTENT=true
+FOO_MCP_HOST=127.0.0.1
+FOO_MCP_PORT=8000
+
+# Provider keys are only required when agents using that provider are invoked.
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+GEMINI_API_KEY=
+GOOGLE_API_KEY=
+
+# Hugging Face hosted inference. HF_TOKEN is the conventional name used by
+# Hugging Face tooling; HUGGINGFACE_API_KEY is also accepted by foo-mcp.
+HF_TOKEN=
+HUGGINGFACE_API_KEY=
+HUGGINGFACE_HUB_TOKEN=
+
+# Optional: improves Hugging Face model download throughput on high-memory Macs.
+HF_XET_HIGH_PERFORMANCE=0

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

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install project + dev extras
+        run: uv sync --extra dev
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check .
+
+      - name: Type check (mypy)
+        run: uv run mypy src
+
+      - name: Unit tests (no live)
+        run: uv run pytest -q

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

@@ -0,0 +1,71 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install project + dev extras
+        run: uv sync --extra dev
+
+      - name: Sanity checks
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run mypy src
+          uv run pytest -q
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Verify distribution metadata
+        run: |
+          uv run --with twine -- twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+          retention-days: 14
+
+  publish:
+    name: Publish to PyPI (trusted publisher)
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/foo-mcp
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

foo_mcp-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+.env
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+runs/
+*.log
+*.code-workspace

foo_mcp-0.1.0/.gitleaks.toml

@@ -0,0 +1,18 @@
+# Extends the bundled gitleaks default rules — see
+# https://github.com/gitleaks/gitleaks/blob/master/config/gitleaks.toml
+[extend]
+useDefault = true
+
+[allowlist]
+description = "Allowlist test stubs and the public env template"
+paths = [
+  '''\.env\.example$''',
+  '''tests/.*\.py$''',
+]
+# Belt-and-suspenders: explicit short stubs used in unit tests, in case
+# any rule fires on them outside the tests/ tree (e.g. quoted in docs).
+regexes = [
+  '''sk-test(-[a-z]+)?''',
+  '''sk-abc123''',
+  '''sk-"abc"-123''',
+]

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

@@ -0,0 +1,9 @@
+# Optional secret-scanning hook. To activate locally:
+#   pip install pre-commit   # or: brew install pre-commit
+#   pre-commit install
+# See README "Secret scanning (optional)" for details.
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.30.1
+    hooks:
+      - id: gitleaks

foo_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Pletta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.