Pi Tools MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Pi Tools MCP
A local stdio MCP server for the built-in coding tools from Pi v1.5.2. The MCP host supplies the model, system prompt, permissions and orchestration. The server runs the vendored Pi tool implementations directly and requires only Node.js 22.19 or later. It exposes the MCP tools capability.
Install
Install the package from the GitHub release.
npm install -g https://github.com/damoyang/pi-tools-mcp/releases/download/v0.1.0/pi-tools-mcp-0.1.0.tgz
pi-tools-mcp --helpFor a local checkout, run:
git clone https://github.com/damoyang/pi-tools-mcp.git
cd pi-tools-mcp
npm ci
node src/cli.js --helpRelated MCP server: Uten Agent Terminal MCP
Connect an MCP client
For clients that accept an mcpServers JSON configuration, point node at the checked-out CLI. Use absolute paths to the CLI and your project.
{
"mcpServers": {
"pi-tools": {
"command": "node",
"args": [
"/absolute/path/to/pi-tools-mcp/src/cli.js",
"--cwd",
"/absolute/path/to/project"
]
}
}
}On Windows, JSON paths such as C:/Projects/pi-tools-mcp/src/cli.js work with the native Node executable. If your client has a different PATH from your terminal, set command to the absolute path to Node. You can also configure a global install using the path to its JavaScript entry point. Run npm root -g to locate the global node_modules directory, then append pi-tools-mcp/src/cli.js.
--cwd defaults to the server's startup directory. --tools read,grep,find,ls exposes only the file inspection tools. Use --shell-path PATH to select a particular Bash executable. A relative shell path is resolved from the server's startup directory. A trusted client can run shell commands and read or modify any files accessible to the server process. --cwd is a base for resolving relative paths.
Tools
Tool | Behavior | Availability |
| Read text with line ranges and truncation, or return an image block | Default |
| Run Bash with optional timeout and output truncation | Default |
| Replace exact text, including multiple targeted edits in one call | Default |
| Create or overwrite a file and create parent directories | Default |
| Search file contents with ripgrep | Default |
| Find paths by glob with fd | Default |
| List directory entries | Default |
| Run Windows PowerShell or PowerShell 7 | Native Windows, enabled with |
Tool arguments are validated against the upstream schemas, after Pi's argument normalization when applicable. Tool failures carry MCP's isError flag, including nonzero shell exit codes. Shell calls include an object in structuredContent with the exit code and output. The server passes request cancellation to Pi's tools. When available, Pi's result details are included in _meta["pi-tools-mcp/details"].
Platforms
Environment | Shell and search tools |
macOS or Linux | Pi's Bash discovery selects system Bash, Bash on |
Native Windows | Install Git for Windows for Bash, set |
WSL | Launch the MCP subprocess with Linux Node inside the distribution. Linux paths, commands, and |
Android (Termux) | Install |
Pi's upstream resolver checks for rg and fd (or fdfind) on the machine. On desktop x64 and ARM64 it can download missing tools from their upstream releases. Downloads use the server's per-user cache, configurable with PI_TOOLS_MCP_BIN_DIR. Set PI_OFFLINE=1 to use existing binaries only.
The GitHub Actions matrix runs the same stdio integration tests on macOS, Linux, and Windows, with native x64 and ARM64 jobs. WSL and Termux use Pi's upstream platform logic and have no separate CI jobs.
Development and provenance
Run npm ci and npm test. The test suite starts the CLI as a subprocess with the official MCP SDK client. The package can be built with npm pack.
The vendored JavaScript is from the npm distribution of Pi v1.5.2. The adapters remove Pi's prompt metadata and terminal rendering and supply the version and binary cache location used by the standalone tools. See third-party notices for the pinned revision, license and regeneration steps.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables reading, writing, editing, searching, running commands, transferring files, and using git on a remote Linux server over SSH via MCP tools.223AGPL 3.0
- AlicenseBqualityCmaintenanceEnables AI agents to run shell commands, execute Python code, read and write files, search text, and create or delete folders through MCP stdio tools.9MIT
- AlicenseAqualityBmaintenanceLocalBridge MCP is a bridge between an online AI chats and your computer. Most online AI chats can reason, and write code, but they normally cannot touch the local files, terminals, and scripts that make real work happen. This gives a trusted assistant a controlled doorway into a machine you own, so it can inspect files, edit text, search a project, run tests, use Git, and operate a shell.173Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to inspect files, search text, compare directories, read symbols, and apply structured edits against large codebases through bounded, local-first MCP tools.4Apache 2.0