{"data":{"slug":"nicobailon-pi-mcp-adapter","name":"pi-mcp-adapter","tagline":"Token-efficient MCP adapter for Pi coding agent","github_url":"https://github.com/nicobailon/pi-mcp-adapter","owner":"nicobailon","repo":"pi-mcp-adapter","owner_avatar_url":"https://avatars.githubusercontent.com/u/2958133?v=4","primary_language":"TypeScript","stars":1499,"forks":354,"topics":["ai","claude","coding-agent","extension","llm","mcp","model-context-protocol","pi"],"archived":false,"github_pushed_at":"2026-09-19T15:25:59+00:00","maintenance_label":"Very active","stars_delta_30d":427,"url":"https://www.graphcanon.com/tools/nicobailon-pi-mcp-adapter","markdown_url":"https://www.graphcanon.com/tools/nicobailon-pi-mcp-adapter.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/nicobailon-pi-mcp-adapter","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=nicobailon-pi-mcp-adapter","description":"Token-efficient MCP adapter for Pi coding agent","homepage_url":null,"license":"MIT","open_issues":4,"watchers":6,"ai_summary":"A TypeScript-based repository that provides an efficient MCP (Model Context Protocol) adapter designed to improve token usage within the context of Pi, an AI coding assistant.","readme_excerpt":"## Install\n\n```bash\npi install npm:pi-mcp-adapter\n```\n\nRestart Pi after installation.\n\n> **DeepSeek Harness (third-party bridge):** Run the unmodified adapter in DSH via [pi2dsh](https://github.com/weijiafu14/pi2dsh); see the [verified dsh-TUI and Web MCP guide](https://github.com/weijiafu14/pi2dsh/tree/main/examples/tui-mcp).\n\n---\n\n## Quick Start\n\nPreferred project config: `.mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"chrome-devtools\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"chrome-devtools-mcp@1.6.0\"]\n    }\n  }\n}\n```\n\nPreferred user-global shared config: `~/.config/mcp/mcp.json` (for all projects). Pi also reads the tool-agnostic global paths `~/.agents/mcp.json` and `~/.agents/mcp/mcp.json` as compatibility inputs.\n\nPi-owned files are not additional normal setup choices. They hold Pi-specific settings, compatibility imports, and adapter-only overrides:\n\n- `<Pi agent dir>/mcp.json` — Pi global override (`~/.pi/agent/mcp.json` by default)\n- `.pi/mcp.json` — Pi project override\n\nHost-specific configs are detected and shown by `/mcp setup` and `pi-mcp-adapter init`, but they are compatibility inputs rather than normal setup paths and are not loaded automatically. The normal `/mcp` panel does not scan host-specific files when `settings.hostConfigDiscovery` is `\"off\"`. To explicitly opt in to host-config fallback discovery, set `settings.hostConfigDiscovery` to `\"on\"` or run `pi-mcp-adapter init --discover-host-configs`. The default is `\"off\"`; `\"prompt\"` is available for integrations that want detection without activation. Host configs are lower precedence than every shared and Pi-owned source, and `/mcp setup` continues to offer explicit import adoption. Discovery reports source paths, provenance, and same-name conflicts; it never writes to external host files or silently launches commands from them.\n\nPrecedence is (later entries win):\n\n1. `~/.config/mcp/mcp.json`\n2. `~/.agents/mcp.json`\n3. `~/.agents/mcp/mcp.json`\n4. `<Pi agent dir>/mcp.json`\n5. `.mcp.json`\n6. `.pi/mcp.json`\n\nAncestor discovery is off by default. To opt in, set `settings.ancestorConfigRoots` in a user-global config above, or in the explicitly selected `--mcp-config`/`configPath` file, for example `\"ancestorConfigRoots\": [\"~/work/team\"]`. Each root must be an explicit absolute path or `~/...`, resolve to an existing directory under `$HOME`, and contain the canonical cwd. If several roots match, only the nearest (deepest) is used. Project `.mcp.json` and `.pi/mcp.json` files cannot enable discovery or extend the boundary.\n\nWithin the selected root, existing `.mcp.json` and `<configDir>/mcp.json` (normally `.pi/mcp.json`) files load between steps 4 and 5, from the root through parent(cwd), farthest first. Nearer directories override farther ones, Pi overrides shared config within each directory, and cwd files win over ancestors. Search never goes above the configured root or `$HOME`; the boundary limits discovery but is not a file-ownership or symlink-target sandbox. Only configure roots whose project files you trust. `/mcp setup` write targets and project-local `/mcp disable` and `/mcp enable` overrides are unchanged.\n\n`/mcp disable <server>` and `/mcp enable <server>` persist only the `disabled` field in the project-local `.pi/mcp.json`, which is the highest-precedence Pi layer. Enabling removes the project flag when lower layers are enabled, or writes `false` when needed to override a disabled lower source. This applies even when the effective server came from a shared global/project file, an imported host config, or `configPath`; the source file is never rewritten and credentials are never copied. Run `/reload` after changing the flag so registered tool surfaces are refreshed. The manual equivalent is to add `{ \"disabled\": true }` to a server in any normal MCP config. Supplied in-memory `createMcpAdapter({ config })` configurations are isolated and do not read or write this project override; the commands are unavailable in that mode.\n\nServers are **la","github_created_at":"2026-01-19T23:23:58+00:00","created_at":"2026-07-11T11:53:07.33195+00:00","updated_at":"2026-10-11T04:00:47.252106+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"}],"tags":[{"slug":"ai","name":"ai"},{"slug":"claude","name":"claude"},{"slug":"coding-agent","name":"coding-agent"},{"slug":"extension","name":"extension"},{"slug":"llm","name":"llm"},{"slug":"mcp","name":"mcp"},{"slug":"model-context-protocol","name":"model-context-protocol"},{"slug":"pi","name":"pi"}],"trust":{"provenance":{"is_fork":false,"github_id":1137850293,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T03:56:13.372Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":29,"days_since_push":0,"last_release_at":"2026-09-14T20:53:06Z","stars_delta_30d":427,"open_issues_delta_30d":0},"security_summary":{"status":"findings","scanner":"osv@v1","low_count":3,"high_count":0,"last_scan_at":"2026-10-11T04:00:46.862Z","medium_count":0,"scan_profile":"deps","critical_count":0}},"capability_facts":{"mcp":{"source":"package.json:@modelcontextprotocol/*","observed_at":"2026-09-20T03:56:14.650Z","server_manifest":true},"scan":{"source":"repo_scan","observed_at":"2026-09-20T03:56:14.650Z"},"has_cli":{"value":true,"source":"package.json:bin|scripts","observed_at":"2026-09-20T03:56:14.650Z"},"languages":{"value":["typescript","javascript"],"source":"github.language+package.json","observed_at":"2026-09-20T03:56:14.650Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T03:56:14.650Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":{"notes":["pi-mcp-adapter operates in a TypeScript environment and requires that the project already supports TypeScript."],"requires_docker":false},"constraints":{"requires_docker":false},"when_to_use":["Use when working with Pi, the AI coding assistant, to optimize token efficiency within Model Context Protocol environments.","When developing applications that require integration with Pi through the MCP and you need to minimize token usage without sacrificing performance."],"when_not_to_use":["Avoid if your project does not align with TypeScript or the Model Context Protocol framework as pi-mcp-adapter is specifically tailored for these contexts.","Do not use when working on projects that do not involve Pi coding assistant, as its functionalities are directly tied to this specific AI tool."],"source":"enrich:decision_facts","observed_at":"2026-07-17T13:17:20.718Z"},"constraint_facets":{"requires_docker":false},"decision_summary":[{"label":"Requirements","value":"pi-mcp-adapter operates in a TypeScript environment and requires that the project already supports TypeScript."},{"label":"Adopt for","value":"pi-mcp-adapter is a TypeScript-based MCP adapter tailored for efficient token usage with Pi, an AI coding assistant."},{"label":"License detail","value":"Licensed under MIT"}]}}