🚀 Karate Feature Graph Analyzer (MCP-Powered)

A powerful Model Context Protocol (MCP) tool designed for AI agents (Claude, Antigravity, Cursor) to analyze Karate Framework feature files, manage multi-project dependencies, and generate interactive graphs.

---

✨ Why use this with AI?

Instead of running scripts manually, you can just chat with your codebase:

• 🔍 Impact Analysis: Ask AI "What happens if I change this API?" and see the exact lines affected.
• 📈 Ecosystem View: Merge multiple projects into one global graph via chat.
• 📝 Source Snippets: View relevant code snippets around dependencies directly in AI search results.
• 🎫 Ticket tracking: Automatically link Jira tags to code components.
• 🩺 Health Check: Get AI-generated reports on cycles and redundant components.

---

🚀 Quick Start (AI-Powered)

1. Installation

git clone <repository-url>
cd karate-feature-graph-analyzer
pip install -e .

2. Configure MCP Client

Add the following to your AI client configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "karate-analyzer": {
      "command": "python",
      "args": ["C:/path/to/repo/src/karate_graph_analyzer/mcp_server.py"],
      "env": {
        "PYTHONPATH": "C:/path/to/repo/src",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

[!IMPORTANT] Replace C:/path/to/repo with the actual absolute path of this repository.

3. Start Analyzing via Chat

Once connected, just ask your AI:

• "Register the project at E:/my-karate-fw and analyze it."
• "Show me all test cases affected by a change in the OrderManagement page."
• "Scan all my registered projects and give me a health summary."

---

🤖 Available AI Tools

Tool	AI Command Example
register_project	"Register my project at [path] as 'Core-Service'"
bulk_analyze	"Scan all my projects and find any issues"
merge_projects	"Merge project A and B to see cross-project dependencies"
impact_analysis	"Which tests break if I modify the @AddPayment scenario?"
search_api	"Find all POST endpoints in the checkout domain"
get_project_health	"Give me a health report for project X"
export_graph	"Export the graph of project Y to JSON"

---

📊 Visualizing Results

The analyzer generates interactive HTML graphs in the output/ directory.

• Color Coding:
  • 🟢 Test Case: Main entry points/Scenarios.
  • 🔵 Workflow: Reusable feature files.
  • 🟠 API: REST/SOAP endpoints.
  • 🟣 Page: Page Objects / UI Logic.
  • 🔴 Database: DB operations.
• Features:
  • Click to Highlight: See exact dependency paths.
  • Interactive Tooltips: View file paths, line numbers, and Jira tags.
  • Legend: Included in the top-right corner.

---

🛠️ Advanced Usage (CLI)

If you still prefer the terminal, you can use the built-in scanners:

Scan a single project

python scan_project.py <path_to_project> <output_name>

Scan multiple projects at once

python scan_all_projects.py <path1> <path2> <parent_folder>

---

📁 Project Structure

karate-feature-graph-analyzer/
├── src/karate_graph_analyzer/
│   ├── mcp_server.py                # MCP Server Entry Point
│   ├── mcp_interface/               # MCP Tool Logic
│   ├── parser/                      # Karate/Gherkin Parser
│   ├── graph/                       # Graph Construction
│   └── visualization/               # HTML/Vis.js Generator
├── output/                          # Generated HTML/JSON files
└── tests/                           # 300+ Unit & Integration tests

---

📝 License

This project is licensed under the MIT License.

Built with ❤️ for the Karate Community.