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).

Related MCP server: MCP of MCPs

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:

Run pixi task list to see every task.

License

MIT — see LICENSE.