ANTLR4 MCP Server

MCP server enabling AI assistants to help with ANTLR4 grammar development.

---

Quick Start

Docker (Recommended)

docker pull sshailabh1/antlr4-mcp-server:latest

Configure your MCP client:

{
  "mcpServers": {
    "antlr4": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "sshailabh1/antlr4-mcp-server:latest"]
    }
  }
}

Build from Source

./mvnw clean package -DskipTests

{
  "mcpServers": {
    "antlr4": {
      "command": "java",
      "args": ["-jar", "/path/to/antlr4-mcp-server-0.2.0.jar"]
    }
  }
}

---

Tools

Tool	Purpose
validate_grammar	Syntax validation with error suggestions
parse_sample	Parse input, return tree (interpreter mode)
detect_ambiguity	Find parsing ambiguities
analyze_left_recursion	Detect recursion patterns
analyze_first_follow	Compute FIRST/FOLLOW sets
analyze_call_graph	Rule dependencies, cycles, unused rules
visualize_atn	ATN state diagrams (DOT/Mermaid)
compile_grammar_multi_target	Generate parsers (10 languages)
profile_grammar	Performance profiling

---

Usage Example

Validate and parse "2 + 3 * 4":

grammar Calc;
expr: expr ('*'|'/') expr | expr ('+'|'-') expr | NUMBER ;
NUMBER: [0-9]+ ;
WS: [ \t\r\n]+ -> skip ;

---

Target Languages

Java, Python, JavaScript, TypeScript, C++, C#, Go, Swift, PHP, Dart

---

Documentation

Document	Purpose
Quick Start	Setup in 5 minutes
Tool Usage	Complete tool reference
Development	Build, test, contribute
Examples	Calculator, JSON grammars

---

Constraints

Constraint	Value
Max grammar size	10 MB
Max input size	1 MB
Timeout	30 seconds
Imports	Not supported (inline all rules)

---

License

Apache License 2.0