# guguzea/mc-ai-coding-assistant-tool architecture

> Architecture diagram of the GitHub repository guguzea/mc-ai-coding-assistant-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guguzea/mc-ai-coding-assistant-tool
- Repository: https://github.com/guguzea/mc-ai-coding-assistant-tool

## Overview

This repository is an AI coding-assistant toolkit for Minecraft mod development. Its central workflow is an agent selecting a platform and exact Minecraft version, consulting platform and community knowledge, then using MCP tools for code generation, project validation, and diagnostics. The README also documents library skills, offline API/documentation data, and Bedrock support. The supplied tree is sparse and the sampled implementation files are mostly tests or scaffolding, so relationships among MCP runtime subsystems are documented capability links rather than source-verified calls.

Main entry points: [`mcp-server/src`](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src) (MCP Server), [`fabric`](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/fabric) (Platform Pack), [`knowledge/libs`](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/knowledge/libs) (Library Skills), [`community_knowledge`](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/community_knowledge) (Community Knowledge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Platform Guidance"]
  node_rules["Platform Rules"]
  node_pack["Platform Pack"]
  node_skills["Library Skills"]
end

subgraph group_knowledge["Knowledge Sources"]
  node_community["Community Knowledge"]
  node_offline[("Offline Docs Data")]
  node_loaderapi[("Loader API Data")]
  node_manifests[("Library Manifests")]
  node_apisummaries[("Library API Summaries")]
end

subgraph group_assistant["MCP Assistant"]
  node_mcp["MCP Server"]
  node_docsearch["Documentation Search"]
  node_apisearch["API Lookup"]
  node_generation["Code Generation"]
  node_validation["Project Validation"]
  node_diagnostics["Crash Diagnostics"]
  node_decompile["Mod Decompilation"]
end

subgraph group_integrations["Mod Platforms"]
  node_platforms["Mod Loader Ecosystem"]
  node_bedrock["Bedrock Add-ons"]
end

node_developer(("Mod Developer"))
node_agent(("AI Coding Agent"))
node_modproject["Mod Project"]

node_developer -->|"requests assistance"| node_agent
node_agent -->|"selects platform version"| node_pack
node_pack -->|"provides rules"| node_rules
node_agent -->|"consults skills"| node_skills
node_agent -->|"invokes tools"| node_mcp
node_mcp -.->|"dispatches search"| node_docsearch
node_docsearch -->|"searches docs"| node_offline
node_agent -->|"searches practices"| node_community
node_mcp -.->|"dispatches lookup"| node_apisearch
node_apisearch -.->|"reads summaries"| node_loaderapi
node_apisearch -.->|"reads summaries"| node_apisummaries
node_apisearch -.->|"reads versions"| node_manifests
node_mcp -.->|"dispatches generation"| node_generation
node_mcp -.->|"dispatches validation"| node_validation
node_mcp -.->|"dispatches diagnosis"| node_diagnostics
node_mcp -.->|"dispatches decompilation"| node_decompile
node_generation -.->|"generates files"| node_modproject
node_validation -.->|"checks project"| node_modproject
node_diagnostics -.->|"analyzes failures"| node_modproject
node_agent -->|"targets loader"| node_platforms
node_agent -->|"targets add-ons"| node_bedrock

click node_rules "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/fabric"
click node_pack "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/fabric"
click node_skills "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/knowledge/libs"
click node_community "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/community_knowledge"
click node_offline "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/data"
click node_mcp "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_docsearch "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_apisearch "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_generation "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_validation "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_diagnostics "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_decompile "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src"
click node_platforms "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/forge"
click node_bedrock "https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/bedrock"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_rules,node_pack,node_skills toneBlue
class node_community,node_offline,node_loaderapi,node_manifests,node_apisummaries toneAmber
class node_mcp,node_docsearch,node_apisearch,node_generation,node_validation,node_diagnostics,node_decompile toneMint
class node_platforms,node_bedrock toneRose
class node_developer,node_agent,node_modproject toneIndigo
```

## Components

### Platform Guidance

- [Platform Rules](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/fabric): `fabric`
- [Platform Pack](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/fabric): `fabric`
- [Library Skills](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/knowledge/libs): `knowledge/libs`

### Knowledge Sources

- [Community Knowledge](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/community_knowledge): `community_knowledge`
- [Offline Docs Data](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/data): `data`
- **Loader API Data**
- **Library Manifests**
- **Library API Summaries**

### MCP Assistant

- [MCP Server](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [Documentation Search](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [API Lookup](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [Code Generation](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [Project Validation](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [Crash Diagnostics](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`
- [Mod Decompilation](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/mcp-server/src): `mcp-server/src`

### Mod Platforms

- [Mod Loader Ecosystem](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/forge): `forge`
- [Bedrock Add-ons](https://github.com/guguzea/mc-ai-coding-assistant-tool/tree/main/bedrock): `bedrock`

### Other components

- **Mod Developer**
- **AI Coding Agent**
- **Mod Project**

## Connections

- Mod Developer → AI Coding Agent: requests assistance (evidence: `README.md`)
- AI Coding Agent → Platform Pack: selects platform version (evidence: `README.md`)
- Platform Pack → Platform Rules: provides rules (evidence: `README.md`)
- AI Coding Agent → Library Skills: consults skills (evidence: `README.md`)
- AI Coding Agent → MCP Server: invokes tools (evidence: `README.md`)
- MCP Server → Documentation Search: dispatches search
- Documentation Search → Offline Docs Data: searches docs (evidence: `README.md`)
- AI Coding Agent → Community Knowledge: searches practices (evidence: `README.md`)
- MCP Server → API Lookup: dispatches lookup
- API Lookup → Loader API Data: reads summaries
- API Lookup → Library API Summaries: reads summaries
- API Lookup → Library Manifests: reads versions
- MCP Server → Code Generation: dispatches generation
- MCP Server → Project Validation: dispatches validation
- MCP Server → Crash Diagnostics: dispatches diagnosis
- MCP Server → Mod Decompilation: dispatches decompilation
- Code Generation → Mod Project: generates files
- Project Validation → Mod Project: checks project
- Crash Diagnostics → Mod Project: analyzes failures
- AI Coding Agent → Mod Loader Ecosystem: targets loader (evidence: `README.md`)
- AI Coding Agent → Bedrock Add-ons: targets add-ons (evidence: `README.md`)
