mymcp: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

As of v3 the server is the Go core in go/. The Python package (src/mymcp) is a recorder-only sidecar; a base install has zero dependencies.

# --- Go core (the server) ---
cd go && go build -o /tmp/mymcp ./cmd/mymcp      # build
/tmp/mymcp serve                                  # run (prints temp tokens to stderr)
cd go && go test ./... && go vet ./... && gofmt -l .

# --- Python recorder sidecar + repo tooling ---
# Editable install with dev + recorder deps (dev now includes [recorder] + the
# mcp client for the compat suite). requirements-dev.txt is a pip-compile
# lockfile used as a constraints file; pyproject.toml stays the source of truth.
pip install -e ".[dev]" -c requirements-dev.txt

# Regenerate the lockfile after changing dependencies in pyproject.toml
pip-compile --extra dev --strip-extras \
  --unsafe-package algony-mymcp --unsafe-package pip --unsafe-package setuptools \
  --output-file requirements-dev.txt pyproject.toml

pytest tests/ -v --benchmark-disable             # Python (recorder) tests
ruff check . && ruff format --check . && mypy src/mymcp
mymcp-recorder                                    # run the sidecar (MYMCP_RECORDER_ENABLED=true)

# --- Compat suite (black-box, run against the Go server) ---
cd go && go build -o /tmp/mymcp ./cmd/mymcp
# boot /tmp/mymcp serve with MYMCP_* env, then:
#   MYMCP_COMPAT_URL=http://127.0.0.1:PORT ... pytest tests/compat/ -v

# --- Package + upgrade (platform wheel bundles the Go binary AS `mymcp`) ---
python -m build --wheel -n                        # pure wheel (assembler input)
python scripts/assemble_wheel.py dist/*.whl <go-binary> manylinux2014_x86_64 platform-dist/
pipx upgrade algony-mymcp && sudo systemctl restart mymcp

Architecture

The server is a Go binary (go/, module github.com/algony-tony/mymcp/go) exposing Linux system tools over MCP Streamable HTTP (stateless) with Bearer token auth. It ships as a platform wheel where the mymcp command IS the Go binary (scripts/assemble_wheel.py injects it into <name>.data/scripts/). The Python package is a recorder-only sidecar — zero base deps; recorder features need the [recorder] extra; the sidecar entry is mymcp-recorder.