Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add ast-grep-mcp -- npx -y ast-grep-mcp@0.0.2In einem Terminal ausführen.
{ "mcpServers": { "ast-grep-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
ast-grep-mcp is a local stdio Model Context Protocol server that gives agents access to the real ast-grep CLI for structural search, scan, rule testing, and explicitly gated rewrites.
It is designed for agentic coding workflows where text search is not enough and filesystem safety matters.
MCP stdio server exposing ast-grep structural search and safe rewrites to agents
ast-grep run and JSON results.ast-grep scan using config files, rule files, inline rules, or filters.ast-grep test.apply: true input... escapes, and symlinks that resolve outside the workspace.The package depends on @ast-grep/cli, which installs the matching platform binary during package installation. You can still override binary resolution with AST_GREP_BIN when needed.
Use it directly from npm in your MCP client configuration:
{
"mcpServers": {
"ast-grep": {
"command": "npx",
"args": ["-y", "ast-grep-mcp"],
"cwd": "/path/to/workspace"
}
}
}
Or install it globally:
npm install -g ast-grep-mcp
{
"mcpServers": {
"ast-grep": {
"command": "ast-grep-mcp",
"cwd": "/path/to/workspace"
}
}
}
Set cwd to the workspace the agent should inspect. Tool paths are resolved relative to that workspace.
Rewrite-capable requests require an explicit apply value:
{
"pattern": "$A && $A()",
"rewrite": "$A?.()",
"apply": false,
"lang": "ts",
"paths": ["src"]
}
apply: false previews replacements and does not pass --update-all.apply: true passes --update-all and applies all replacements or scan rule fixes.rewrite requires apply, so callers must explicitly choose preview or mutation.apply: true without a rewrite or fix-capable scan request is rejected.For ast_grep_scan, fixes must be defined in ast-grep rules or config. scan does not accept an ad-hoc rewrite string.
The server resolves ast-grep in this order:
AST_GREP_BINast-grep on PATHsg on PATH, only when sg --version identifies ast-grep@ast-grep/cli dependencyUse ast_grep_version to confirm which binary the server selected.
.. escapes are rejected.spawn argv arrays with shell: false.structuredContent.pnpm install
pnpm run verify
Useful scripts:
For local MCP development against this repository:
{
"mcpServers": {
"ast-grep": {
"command": "pnpm",
"args": ["run", "dev"],
"cwd": "/path/to/ast-grep-mcp"
}
}
}
When developing the server itself, launch it from this repository. When using the published package, set cwd to the target workspace.
This project uses Changesets and GitHub Actions.
pnpm changeset for user-facing changes.main. The release workflow opens or updates a version PR.NPM_TOKEN.Repository maintainers need to configure an npm automation token as the NPM_TOKEN GitHub Actions secret.
MIT
MCP stdio server exposing ast-grep structural search and safe rewrites to agents
{ "mcpServers": { "ast-grep-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Ast Grep läuft lokal über stdio.
Zuletzt geprüft: 2026-11-15. MCP stdio server exposing ast-grep structural search and safe rewrites to agents