Files

T

History

Matt Van Horn 61d46b54ee fix(mcp): dedup PYTHONPATH and drop unsupported win32 platform

Addresses two Greptile findings on #428.

P1 - buildEnv duplicated PYTHONPATH when the parent environment already
set one. POSIX getenv returns the first match, so the user's stale
PYTHONPATH would shadow the engine's cache dir and break
`from lib import ...` with ModuleNotFoundError. buildEnv now filters
any incoming PYTHONPATH= entry before appending the cache dir. Adds
TestRunDropsPreExistingPythonPath (end-to-end through the stub
interpreter) and TestBuildEnvDropsAllPreExistingPythonPath (direct
unit on the helper) to cover the missed case.

P2 - manifest.compatibility.platforms listed "win32" even though the
release matrix doesn't ship a Windows binary; Claude Desktop would
let Windows users start an install with no matching artifact.
Removed until the Windows packaging follow-up lands. Manifest test
renamed to TestPlatformsMatchShippingMatrix and tightened: now
forbids platforms the release CI doesn't build, with a message
pointing at .github/workflows/release.yml.

go test ./... 38 passed across 4 packages.

2026-05-17 21:18:05 -07:00

cmd/last30days-pp-mcp

feat(mcp): stdio MCP server with research tool

2026-05-17 20:51:00 -07:00

internal

fix(mcp): dedup PYTHONPATH and drop unsupported win32 platform

2026-05-17 21:18:05 -07:00

scripts

feat(mcp): embed Python engine and extract to user cache

2026-05-17 20:46:29 -07:00

.gitignore

feat(mcp): embed Python engine and extract to user cache

2026-05-17 20:46:29 -07:00

go.mod

feat(mcp): stdio MCP server with research tool

2026-05-17 20:51:00 -07:00

go.sum

feat(mcp): stdio MCP server with research tool

2026-05-17 20:51:00 -07:00

manifest.json

fix(mcp): dedup PYTHONPATH and drop unsupported win32 platform

2026-05-17 21:18:05 -07:00

README.md

feat(mcp): embed Python engine and extract to user cache

2026-05-17 20:46:29 -07:00

README.md

last30days-pp-mcp

Go MCP server that wraps the last30days Python engine for Claude Desktop. Packaged as a .mcpb bundle (drag-drop install into Claude Desktop).

The MCP server exposes a single research tool that mirrors the /last30days <topic> slash command available in Claude Code. At runtime the binary extracts the vendored Python engine into a per-user cache and shells out to python3 to produce the synthesis input Claude renders.

Architecture

cmd/last30days-pp-mcp/ - server entry point
internal/engine/ - embed.FS of the Python engine + cache extractor + subprocess wrapper
internal/tools/ - MCP tool handlers (currently research)
internal/engine/vendored/ - mirror of skills/last30days/scripts/, generated by scripts/sync-engine.sh (gitignored). Lives inside the engine package because //go:embed cannot reach files outside its own package directory.
manifest.json - MCPB v0.3 manifest consumed by Claude Desktop and printing-press bundle

Local build

# Mirror the Python engine into vendored/.
bash scripts/sync-engine.sh

# Build for the current host.
go build -ldflags "-X main.Version=dev" -o build/last30days-pp-mcp ./cmd/last30days-pp-mcp

# Package as a .mcpb (requires the printing-press binary on PATH).
printing-press bundle . --skip-build --binary build/last30days-pp-mcp

The output .mcpb lands at build/last30days-pp-mcp-<os>-<arch>.mcpb. Drag it into Claude Desktop's Extensions panel to install.

Runtime requirements

End users need Python 3.12+ on PATH. The bundle ships the engine source but relies on the host interpreter.

Versioning

The MCPB manifest.json version is hand-bumped in the same PR that ships engine changes worth releasing. Release CI stamps the Go binary's main.Version from the tag.