D&D Knowledge Navigator

Name: D&D Knowledge Navigator
Author: procload

@procload

リポジトリ

D&D Knowledge Navigator について

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

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

基本情報

カテゴリ

メモリとナレッジ

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

procload

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.