Ast Grep MCP Server

@ast-grep

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

ast-grep

提交者

Herrington Darkholme (えっちチャン)

关于 Ast Grep MCP Server

暂无概览

#ast-grep#code-search #mcp

Ast Grep MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "ast-grep": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo",
        "run",
        "main.py"
      ],
      "env": {}
    }
  }
}

Ast Grep MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Ast Grep?

Ast Grep is an experimental Model Context Protocol (MCP) server that gives AI assistants structural code search capabilities using ast-grep, an Abstract Syntax Tree (AST) pattern matching tool. It is designed for developers using MCP‑compatible clients like Cursor or Claude Desktop to analyze codebases by syntax structure rather than plain text.

How to use Ast Grep?

Install ast‑grep and uv, clone the repository, run uv sync, then configure your MCP client (Cursor or Claude Desktop) to run main.py with uv. Alternatively, run directly via uvx without cloning: uvx --from git+https://github.com/ast-grep/ast-grep-mcp ast-grep-server. Optionally set a custom ast‑grep config file using --config flag or AST_GREP_CONFIG environment variable.

Key features of Ast Grep

Visualize AST structure with dump_syntax_tree
Test YAML rules against code snippets with test_match_code_rule
Simple pattern search with find_code
Advanced rule‑based search with find_code_by_rule
Supports dozens of languages including JavaScript, Python, Rust, Go, Java, C/C++, C#
Configurable via custom sgconfig.yaml for rule behavior and custom languages

Use cases of Ast Grep

Debug why an ast‑grep pattern isn't matching by inspecting the AST
Validate and iterate on search rules before applying them to a full codebase
Find all instances of a specific function call or variable declaration
Search for complex nested code structures using relational constraints like inside, has, precedes, follows
Develop and test multi‑condition YAML rules interactively with an AI assistant

常见问题

What are the prerequisites to use Ast Grep?

You need ast‑grep installed (via brew, nix, or cargo), uv (Python package manager), and an MCP‑compatible client like Cursor or Claude Desktop.

How can I run Ast Grep without cloning the repository?

Use `uvx` directly: `uvx --from git+https://github.com/ast-grep/ast-grep-mcp ast-grep-server`.

What languages does Ast Grep support?

Ast Grep supports many programming languages including JavaScript/TypeScript, Python, Rust, Go, Java, C/C++, C#, and more. Custom languages can be added via `sgconfig.yaml`.

How do I configure custom ast‑grep settings?

Provide a `sgconfig.yaml` file either via the `--config` command‑line argument or the `AST_GREP_CONFIG` environment variable.

What should I do if no matches are found?

Make sure ast‑grep is installed and in your PATH. For relational rules, try adding `stopBy: end`. Use `dump_syntax_tree` to understand the AST structure of your target code.

其他分类下的更多 MCP 服务器

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3