Azgaarnoth

Provides access to the Azgaarnoth world repository via MCP tools for querying, retrieving, and exploring content.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thomasserio-azgaarnoth-mcp": {
      "command": "pnpm",
      "args": [
        "mcp"
      ]
    }
  }
}

You run the Azgaarnoth MCP Server to give AI assistants access to the Azgaarnoth D&D world repository. It exposes a set of tools that let you search, retrieve, and explore world content, including creatures, spells, nations, and geography. You can also connect a client like Claude Desktop to query the server and use the tools directly from your workspace.

How to use

Start the MCP server locally, then connect your MCP client to perform actions like searching the world repository, retrieving documents, and browsing categories.

Run the MCP server with the following command to start listening for client requests.

pnpm mcp

How to install

Prerequisites you need before installing and running the server.

- Install Node.js and npm (Node.js 14.x or newer is recommended). If you don’t have it, download from the official site and install.
- Install pnpm as a package manager if you will use it to install dependencies.

Step-by-step commands you should run.

pnpm install

pnpm mcp

Configuration

Configure the repository path that the MCP server should load. The server expects a path to the Azgaarnoth content repository in the code that starts the server.

const REPO_PATH = '~/path/to/Azgaarnoth'

Notes

You can also connect a client to the server to extend your workflow. For example, you can add the Azgaarnoth MCP server to Claude Desktop to enable quick access to world data through the tools provided by the MCP server.

Available tools

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