How ogmatrix/mcmodding-mcp works
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: index.ts MCP server · store.ts Documentation database · search-service.ts Documentation search · example-service.ts Code example retrieval
Components 22
MCP Server
- MCP server
src/index.ts - Docs search tool
src/tools/searchDocs.ts - Example tool
src/tools/getExample.ts - Concept tool
src/tools/explainConcept.ts - Version tool
src/tools/getMinecraftVersion.ts - Mappings tools
src/tools/mappings.ts - Mod examples tool
src/tools/modExamples.ts
Knowledge Retrieval
- Documentation search
src/services/search-service.ts - Code example retrieval
src/services/example-service.ts - Concept explanations
src/services/concept-service.ts - Parchment mappings
src/services/mappings-service.ts - Mod example retrieval
src/services/mod-examples-service.ts - Embedding generation
src/indexer/embeddings.ts
Knowledge Data
- Documentation database
src/indexer/store.ts - Mappings database
- Mod examples database
Data Operations
- Database manager
src/cli/manage.ts - Database versioning
src/db-versioning.ts - Documentation indexing
src/indexer
Other components
- AI MCP client
- Official documentation sources
- Database release host
Connections 25
- 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