# ogmatrix/mcmodding-mcp architecture

> Architecture diagram of the GitHub repository ogmatrix/mcmodding-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ogmatrix/mcmodding-mcp
- Repository: https://github.com/ogmatrix/mcmodding-mcp

## Overview

MCModding-MCP is an MCP server that gives AI assistants searchable Minecraft modding references. An MCP client invokes the server, which dispatches tool requests to documentation, example, concept, version, mapping, or mod-example handlers; retrieval services query their respective datasets and return formatted results. The repository also includes database installation/update management and documentation indexing components. The README documents additional mapping lookups beyond the sampled handlers; their internal routing is not shown here, so those links are omitted.

Main entry points: [`src/index.ts`](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/index.ts) (MCP server), [`src/indexer/store.ts`](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/indexer/store.ts) (Documentation database), [`src/services/search-service.ts`](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/search-service.ts) (Documentation search), [`src/services/example-service.ts`](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/example-service.ts) (Code example retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["MCP Server"]
  node_server["MCP server<br/>[index.ts]"]
  node_docs_tool["Docs search tool<br/>[searchDocs.ts]"]
  node_example_tool["Example tool<br/>[getExample.ts]"]
  node_concept_tool["Concept tool<br/>[explainConcept.ts]"]
  node_version_tool["Version tool"]
  node_mapping_tool["Mappings tools<br/>[mappings.ts]"]
  node_mod_tool["Mod examples tool<br/>[modExamples.ts]"]
end

subgraph group_retrieval["Knowledge Retrieval"]
  node_docs_search["Documentation search<br/>[search-service.ts]"]
  node_example_search["Code example retrieval<br/>[example-service.ts]"]
  node_concept_search["Concept explanations<br/>[concept-service.ts]"]
  node_mapping_search["Parchment mappings"]
  node_mod_search["Mod example retrieval"]
  node_embeddings["Embedding generation<br/>[embeddings.ts]"]
end

subgraph group_datasets["Knowledge Data"]
  node_doc_store[("Documentation database<br/>[store.ts]")]
  node_mapping_db[("Mappings database")]
  node_mod_db[("Mod examples database")]
end

subgraph group_operations["Data Operations"]
  node_manager["Database manager<br/>[manage.ts]"]
  node_versioning["Database versioning<br/>[db-versioning.ts]"]
  node_indexer["Documentation indexing"]
end

node_client(("AI MCP client"))
node_sources(("Official documentation sources"))
node_release_host(("Database release host"))

node_client -->|"sends requests"| node_server
node_server -->|"dispatches search"| node_docs_tool
node_server -->|"dispatches request"| node_example_tool
node_server -->|"dispatches request"| node_concept_tool
node_server -->|"dispatches request"| node_version_tool
node_server -->|"dispatches request"| node_mapping_tool
node_server -->|"dispatches request"| node_mod_tool
node_docs_tool -->|"searches docs"| node_docs_search
node_example_tool -->|"retrieves examples"| node_example_search
node_concept_tool -->|"explains concepts"| node_concept_search
node_mapping_tool -->|"queries mappings"| node_mapping_search
node_mod_tool -->|"searches examples"| node_mod_search
node_docs_search -->|"queries"| node_doc_store
node_docs_search -->|"generates vectors"| node_embeddings
node_example_search -->|"queries"| node_doc_store
node_example_search -->|"generates vectors"| node_embeddings
node_concept_search -->|"queries"| node_doc_store
node_concept_search -->|"searches semantically"| node_embeddings
node_mapping_search -->|"reads"| node_mapping_db
node_mod_search -->|"reads"| node_mod_db
node_server -->|"checks updates"| node_versioning
node_manager -->|"downloads databases"| node_release_host
node_versioning -->|"checks releases"| node_release_host
node_sources -->|"provides documentation"| node_indexer
node_indexer -->|"builds index"| node_doc_store

click node_server "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/index.ts"
click node_docs_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/searchDocs.ts"
click node_example_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/getExample.ts"
click node_concept_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/explainConcept.ts"
click node_version_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/getMinecraftVersion.ts"
click node_mapping_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/mappings.ts"
click node_mod_tool "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/modExamples.ts"
click node_docs_search "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/search-service.ts"
click node_example_search "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/example-service.ts"
click node_concept_search "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/concept-service.ts"
click node_mapping_search "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/mappings-service.ts"
click node_mod_search "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/mod-examples-service.ts"
click node_embeddings "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/indexer/embeddings.ts"
click node_doc_store "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/indexer/store.ts"
click node_manager "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/cli/manage.ts"
click node_versioning "https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/db-versioning.ts"
click node_indexer "https://github.com/ogmatrix/mcmodding-mcp/tree/dev/src/indexer"

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_server,node_docs_tool,node_example_tool,node_concept_tool,node_version_tool,node_mapping_tool,node_mod_tool,node_client toneBlue
class node_docs_search,node_example_search,node_concept_search,node_mapping_search,node_mod_search,node_embeddings,node_release_host toneAmber
class node_doc_store,node_mapping_db,node_mod_db toneMint
class node_manager,node_versioning,node_indexer toneRose
class node_sources toneIndigo
```

## Components

### MCP Server

- [MCP server](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/index.ts): `src/index.ts`
- [Docs search tool](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/searchDocs.ts): `src/tools/searchDocs.ts`
- [Example tool](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/getExample.ts): `src/tools/getExample.ts`
- [Concept tool](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/explainConcept.ts): `src/tools/explainConcept.ts`
- [Version tool](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/getMinecraftVersion.ts): `src/tools/getMinecraftVersion.ts`
- [Mappings tools](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/mappings.ts): `src/tools/mappings.ts`
- [Mod examples tool](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/tools/modExamples.ts): `src/tools/modExamples.ts`

### Knowledge Retrieval

- [Documentation search](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/search-service.ts): `src/services/search-service.ts`
- [Code example retrieval](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/example-service.ts): `src/services/example-service.ts`
- [Concept explanations](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/concept-service.ts): `src/services/concept-service.ts`
- [Parchment mappings](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/mappings-service.ts): `src/services/mappings-service.ts`
- [Mod example retrieval](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/services/mod-examples-service.ts): `src/services/mod-examples-service.ts`
- [Embedding generation](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/indexer/embeddings.ts): `src/indexer/embeddings.ts`

### Knowledge Data

- [Documentation database](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/indexer/store.ts): `src/indexer/store.ts`
- **Mappings database**
- **Mod examples database**

### Data Operations

- [Database manager](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/cli/manage.ts): `src/cli/manage.ts`
- [Database versioning](https://github.com/ogmatrix/mcmodding-mcp/blob/dev/src/db-versioning.ts): `src/db-versioning.ts`
- [Documentation indexing](https://github.com/ogmatrix/mcmodding-mcp/tree/dev/src/indexer): `src/indexer`

### Other components

- **AI MCP client**
- **Official documentation sources**
- **Database release host**

## Connections

- AI MCP client → MCP server: sends requests
- MCP server → Docs search tool: dispatches search
- MCP server → Example tool: dispatches request
- MCP server → Concept tool: dispatches request
- MCP server → Version tool: dispatches request
- MCP server → Mappings tools: dispatches request
- MCP server → Mod examples tool: dispatches request
- Docs search tool → Documentation search: searches docs
- Example tool → Code example retrieval: retrieves examples
- Concept tool → Concept explanations: explains concepts
- Mappings tools → Parchment mappings: queries mappings
- Mod examples tool → Mod example retrieval: searches examples
- Documentation search → Documentation database: queries
- Documentation search → Embedding generation: generates vectors
- Code example retrieval → Documentation database: queries
- Code example retrieval → Embedding generation: generates vectors
- Concept explanations → Documentation database: queries
- Concept explanations → Embedding generation: searches semantically
- Parchment mappings → Mappings database: reads
- Mod example retrieval → Mod examples database: reads
- MCP server → Database versioning: checks updates
- Database manager → Database release host: downloads databases
- Database versioning → Database release host: checks releases
- Official documentation sources → Documentation indexing: provides documentation
- Documentation indexing → Documentation database: builds index