Permet aux agents de codage d'effectuer des recherches ripgrep sensibles aux tokens et des modifications atomiques sur plusieurs fichiers afin de réduire l'utilisation de la fenêtre de contexte.
Aussi connu sous BasilSkyWalk/parecode
- Étoiles
- 5
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.7.0
- Dernier commit
- 14 sept. 2026
- Licence
- MIT
Qu'est-ce que parecode MCP ?
parecode est un serveur MCP. Permet aux agents de codage d'effectuer des recherches ripgrep sensibles aux tokens et des modifications atomiques sur plusieurs fichiers afin de réduire l'utilisation de la fenêtre de contexte.
Résumé généré à partir du README du projet
À propos du MCP server parecode
Les agents de codage qui doivent naviguer dans de vastes bases de code sans épuiser leur fenêtre de contexte peuvent utiliser parecode pour effectuer des recherches sensibles aux tokens et des modifications multi-fichiers. En utilisant l'installation ripgrep du système, le serveur fournit des outils tels que ParecodeSearch et ParecodeEdit qui condensent plusieurs appels d'outils traditionnels en une seule opération efficace. Cette approche est conçue pour réduire à la fois la consommation de tokens et le nombre de tours nécessaires pour accomplir des tâches de refactorisation complexes.
Les développeurs utilisant Claude Code peuvent installer le serveur localement via npm. Le processus d'installation inclut un hook SessionStart optionnel pour donner la priorité à ces outils spécialisés, ainsi qu'un plugin parecode-explore qui utilise un sous-agent moins coûteux pour les questions de type exploration. Le système fonctionne entièrement sur la machine locale sans aucun appel réseau ni télémétrie, garantissant que les données de code et les journaux de session restent privés. Les utilisateurs peuvent suivre leur efficacité grâce aux journaux de session locaux qui estiment les tokens économisés.
Ce que vous pouvez faire avec
- 1Refactorisation multi-fichiers efficaceUn agent peut trouver chaque point d'appel d'un symbole spécifique à travers plusieurs fichiers et appliquer des modifications sur l'ensemble en un seul lot.
- 2Exploration de code contextuelleUn développeur peut demander où se situe un composant spécifique ou comment fonctionne une fonction en utilisant un sous-agent à faible coût pour économiser les tokens de la session principale.
- 3Recherche de code cibléeRecherchez simultanément plusieurs motifs liés pour tracer des flux d'événements sans exécuter de commandes grep distinctes.
- 4Élargissement des résultats de rechercheAprès avoir trouvé une ligne spécifique d'intérêt, un agent peut élargir la plage de code visible sans avoir à relire l'intégralité du fichier.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer parecode MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller parecode MCP dans Claude Code
$ claude mcp add parecode -- npx -y parecodeInstaller parecode MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Installer parecode MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"parecode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Installer parecode MCP dans VS Code CLI
$ code --add-mcp '{"name":"parecode","type":"stdio","command":"npx","args":["-y","parecode"]}'Installer parecode MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Installer parecode MCP dans Codex
$ codex mcp add parecode -- npx -y parecodeInstaller parecode MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.parecode] command = "npx" args = ["-y", "parecode"]
Installer parecode MCP dans Gemini CLI
$ gemini mcp add -s user parecode npx -- -y parecodeInstaller parecode MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblebasilskywalk/parecode is public and reachablegithub.com/basilskywalk/parecode ↗Réussi
- Le nom du package correspond au dépôt sourceparecode names basilskywalk/parecode as sourcenpmjs.com/package/parecode ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for parecodenpmjs.com/package/parecode/v/0.7.0#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-09-14github.com/basilskywalk/parecode ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from parecodeRéussi
- Aucun avis critique dans le package ou ses dépendances114 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubparecode
An MCP server that gives coding agents context-window-aware search and safe, atomic multi-file edits — built to cut token usage on large codebases without giving up correctness.
Requirements
- Node.js 20 or newer (ESM, native test runner, stable
fetch-free runtime). - ripgrep on
PATH(rgon Linux/macOS,rg.exeon Windows). Install via your package manager:- macOS:
brew install ripgrep - Debian/Ubuntu:
apt install ripgrep - Windows:
winget install BurntSushi.ripgrep.MSVCorchoco install ripgrep
- macOS:
- A supported MCP client (Claude Code is the reference target).
Parecode does not bundle ripgrep — it shells out to the system binary so you stay on a single, audited version.
Install
npm install -g parecode
Pure JavaScript — no native dependencies, no C/C++ toolchain required.
Quick start
Register the server with Claude Code:
parecode init # user scope; installs MCP + SessionStart hook + parecode-explore plugin (defaults)
parecode init --scope project # commit MCP config + hook to the repo
parecode init --no-hook # register MCP only; skip the SessionStart hook
parecode init --no-plugin # skip the parecode-explore Claude Code plugin
parecode init --print # print the equivalent command without running it
parecode init --remove-hook # remove the SessionStart hook (MCP stays registered)
parecode init --remove-plugin # uninstall the parecode-explore Claude Code plugin
The SessionStart hook injects a short directive at the start of each session telling Claude to prefer ParecodeSearch / ParecodeEdit over the equivalent native tools. Without it, Claude's first-party Grep / Read / Edit tools typically win by default and Parecode's token savings never land. The hook payload is a static string; parecode hook session-start prints it. Pass --no-hook if you would rather opt in explicitly per session via your own tooling.
The bundled parecode-explore Claude Code plugin adds a read-only subagent (pinned to Haiku, given only ParecodeSearch) and a matching skill, so exploration-style questions ("where is X?", "how does Y work?", "find all usages of Z") get answered in a cheap, isolated context window instead of burning tokens in your main session. init registers a local marketplace pointing at the npm-installed copy and runs claude plugin install parecode-explore@parecode. If your Claude Code build doesn't support the plugin subcommand the step soft-fails with a warning and the rest of init still succeeds; pass --no-plugin to skip it entirely, or --with-plugin to make any plugin-step failure hard-fail.
Then in any session, the ParecodeSearch, ParecodeExpand, and ParecodeEdit tools become available. Run parecode doctor to confirm registration, hook status, and .codegraph/ pairing if present.
What it does
ParecodeSearch— ripgrep-backed search that returns matches with surrounding context windows in a single call, with per-file byte chunking so large result sets do not blow up your context.patternaccepts a single string or an array of strings; arrays dispatch parallel ripgrep runs sharing the samepaths/contextLines, and each match carries apatterns: string[]field listing which input patterns contributed. One call replaces N back-to-back greps for related-keyword flow tracing.- Overlapping or adjacent windows within the same file are merged automatically (gap ≤
contextLines), with bridging lines loaded from disk. - Per-match and response-level
estimatedTokensare returned so the agent can self-budget before consuming results. - Opt-in
relatedSymbols: truesurfaces likely event-flow neighbours (Handle<X>,On<X>,<X>Handler/Listener/Closed/Completed/Started) discovered in each match, capped at 10. - Omitted line ranges are reported so the agent can widen with
ParecodeExpandwithout re-reading the whole file.
ParecodeExpand— widen a known(file, startLine, endLine)range with optionalcontextBefore/contextAfterpadding. Designed as the natural follow-up to aParecodeSearchmatch. Returns the sameestimatedTokensshape so the same self-budgeting heuristic applies. Prefer this over a full-fileReadafter locating a line.ParecodeEdit— batched multi-file edits with whitespace-tolerant fuzzy matching (and an opt-in Unicode-lookalike mode), pre/poststatconflict detection, and atomic same-directory rename writes. Cross-file edits run in parallel.parecode stats— local JSONL session log with token-saved estimates. Zero network. Zero telemetry.
Measured savings
On search-and-edit tasks — finding call sites, multi-file refactors, "do X to every Y" — Parecode cut cost ~40% and assistant turns ~75–83% in matched A/B tests:
| repo | task | cost | turns |
|---|---|---|---|
| TypeScript | find every call site of a symbol, edit each (17 sites, 8 files) | −43% | −83% |
| Unity / C# | find every call site of a symbol, edit each (11 sites, 5 files) | −41% | −76% |
Method: the identical task run with Parecode on vs off, a fresh session per run, n=3 per arm with alternated order, Sonnet 4.6. Savings come from collapsing many Grep / Read / Edit round-trips into single ParecodeSearch / ParecodeEdit calls — so the win scales with how much searching and multi-file fan-out a task involves, and shrinks toward zero on single-file or reasoning-heavy tasks. These are measured per-session token and cost numbers, not the estimates in the scan below.
Retroactive Savings Scan
Curious how much Parecode would have saved you if you had installed it earlier? You can scan your past Claude Code sessions:
parecode stats --retroactive --since 30d
Sample output:
Parecode — last 30d (retroactive scan)
─────────────────────
Sessions: 42
Tool calls: 156
Calls batched (est): 89
Tokens saved (est): 1,200,000
* Note: Retroactive savings are estimated, not measured.
Privacy disclaimer: This scan runs entirely locally against Claude Code's session transcripts (~/.claude/projects/**). By default, it parses only structured fields (tool names, paths, patterns, and token counts). It does not send any data over the network. The --include-content flag (which allows reading tool input/output) is strictly opt-in and loudly flagged if used.
Privacy
Parecode performs no network calls at runtime. Session logs are written to your OS data directory (resolved via env-paths) with 0600 permissions on Unix. Logs are self-maintaining: each server start prunes session data older than 30 days and caps the envelope log at 5 MB. Prune earlier with parecode prune <days> or wipe the data dir. Update to the latest release (and refresh hooks/plugin) with parecode update.
License
Questions sur parecode MCP
Comment ajouter parecode MCP à Claude Code ?
Exécutez claude mcp add parecode -- npx -y parecode dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter parecode MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Est-ce que parecode inclut ripgrep ?
Non, il fait appel au binaire du système pour que vous puissiez utiliser votre propre version auditée.
Combien puis-je économiser en utilisant parecode ?
Lors de tests A/B comparatifs, il a réduit les coûts d'environ 40 % et le nombre de tours de l'assistant de 75 à 83 % sur les tâches de recherche et de modification.