pixi-task

A secure MCP server providing controlled access to pixi tasks and commands, eliminating agent bash circumvention.

Overview

Exposes 11 pixi tools through 4 lean meta-tools (discover_tools, get_tool_spec, execute_tool, server_info) for ~95% context savings compared to a traditional MCP server that advertises every tool individually.

Two transports are supported:

• stdio — exposes the full registry (11 tools).
• HTTP — gates the surface to core + extended complexity (7 tools); use this for daemonised deployments. Default port: 4101.

Both transports surface a server_info meta-tool for self-identification (name, version, transport label, live tool counts, source URLs).

Development

pixi install -e quality
pixi run test
pixi run lint
pixi run format
pixi run typecheck

The HTTP server can be run directly:

pixi run http-server --port 4101

For background operation, the repo ships a systemd user unit at ~/.config/systemd/user/pixi-task.service.

Available Tasks

The canonical task list lives in [tool.pixi.tasks] in pyproject.toml. Key tasks:

Task	Purpose
test	pytest suite (timeout 30s)
test-cov	pytest with coverage
lint	ruff lint (F + E9 rules)
lint-full	full ruff lint
format	ruff format
typecheck	mypy on src/
quality	combined lint + format-check + typecheck
http-server	start the HTTP MCP transport
lean-server	start the stdio MCP transport

Run pixi task list to see every task.

License

MIT — see LICENSE.