D&D Knowledge Navigator

@procload

About D&D Knowledge Navigator

MCP Server implementation of the DnD 5e API using resources, tools, and prompts.

#dnd-mcp #dnd-knowledge-navigator #api-integration

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "dnd-mcp": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is D&D Knowledge Navigator?

A Python-based server implementing the Model Context Protocol (MCP) that connects Claude and other AI assistants to Dungeons & Dragons 5e game information. It uses FastMCP to create a structured bridge between AI assistants and the D&D 5e API, intended for players, game masters, and D&D enthusiasts.

How to use D&D Knowledge Navigator?

Install with Python 3.10+, clone the repo, install dependencies (e.g., uv pip install -r requirements.txt), and configure Claude Desktop by adding the server to claude_desktop_config.json. Run the server with uv run python dnd_mcp_server.py. Once connected, AI assistants can call tools like search_all_categories, verify_with_api, and check_api_health.

Key features of D&D Knowledge Navigator

FastMCP Integration for AI tool access
Complete D&D 5e API integration (spells, monsters, equipment)
Efficient local caching for faster responses
Structured data access with well-defined resources
Source attribution with confidence levels
Visual formatting with Markdown templates
Query enhancement with synonym handling and fuzzy matching

Use cases of D&D Knowledge Navigator

Querying D&D 5e spells, monsters, and equipment during game prep
Verifying D&D rule statements against official API data
Searching across all D&D resource categories for specific terms
Integrating D&D lore and mechanics into AI-assisted storytelling

FAQ from D&D Knowledge Navigator

What is the Model Context Protocol (MCP)?

MCP is a framework developed by Anthropic that enables AI assistants like Claude to communicate with external tools and services. This server uses FastMCP, Anthropic's Python implementation, to bridge AI assistants and the D&D 5e API.

What are the prerequisites to run the server?

Python 3.10 or higher, the uv package manager (recommended), and optionally the Claude Desktop client for using it with Claude.

Does the server cache data?

Yes, the server maintains a local cache in the cache/ directory to minimize API calls and improve response time. This cache is excluded from version control.

Can I disable templates or query enhancement?

Yes. Set TEMPLATES_ENABLED = False in src/templates/config.py to disable templates. For query enhancement, set parameters in the enhance_query function to False.

How do I configure the server for Claude Desktop?

Create a claude_desktop_config.json file in your Claude Desktop configuration directory with the server command, arguments pointing to the dnd_mcp_server.py file, and the path to uv. See the README for a full example.

Frequently asked questions

What is the Model Context Protocol (MCP)?

What are the prerequisites to run the server?

Python 3.10 or higher, the uv package manager (recommended), and optionally the Claude Desktop client for using it with Claude.

Does the server cache data?

Yes, the server maintains a local cache in the `cache/` directory to minimize API calls and improve response time. This cache is excluded from version control.

Can I disable templates or query enhancement?

Yes. Set `TEMPLATES_ENABLED = False` in `src/templates/config.py` to disable templates. For query enhancement, set parameters in the `enhance_query` function to `False`.

How do I configure the server for Claude Desktop?

Create a `claude_desktop_config.json` file in your Claude Desktop configuration directory with the server command, arguments pointing to the `dnd_mcp_server.py` file, and the path to `uv`. See the README for a full example.