Azgaarnoth MCP Server
An MCP (Model Context Protocol) server that provides AI assistants with tools to query the Azgaarnoth D&D world repository (~4,200 markdown files).
Installation
pnpm install
Usage
Run the MCP server
pnpm mcp
Add to Claude Desktop
Command Line:
claude mcp add azgaarnoth -- pnpm --dir ~/path/to/azgaarnoth-mcp mcp
Available Tools
| Tool | Description |
|---|---|
search_world | Full-text search across all Azgaarnoth content |
get_document | Retrieve a specific document by path or name |
browse_category | List all items in a category (races, classes, nations, etc.) |
get_stat_block | Get D&D creature stat blocks |
get_spell | Get spell information |
get_related | Find related documents via links/backlinks |
explore_region | Get nation/city info with political relations |
index_status | Check index statistics |
Categories
races- Playable races and subracesclasses- Character classes and subclassesfeats- Character featsnations- Political entitiesgeography- Geographical regionscities- Major citiesorganizations- Mage schools, mercenary companies, guildscreatures- Monsters with stat blocksmagic- Spells, items, runes, tattoospeople- Named NPCsreligions- Pantheons and faithshistory- Timeline and historical eventsconditions- Game conditionscultures- Cultural backgroundsequipment- Armor, weapons, tools
Configuration
The repository path is configured in src/mcp/server.ts:
const REPO_PATH = '~/path/to/Azgaarnoth'