D&D Knowledge Navigator

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.