Panda3D MCP Server

A Model Context Protocol (MCP) server that enables Claude to search and retrieve Panda3D documentation seamlessly during conversations.

Server Name

What is Panda3D?

Panda3D is a powerful, open-source 3D game engine and rendering library. Originally developed by Disney and maintained by Carnegie Mellon University's Entertainment Technology Center, it provides:

• A complete framework for 3D rendering, physics, animation, and game development

• Python and C++ APIs for development flexibility

• Cross-platform support (Windows, macOS, Linux)

• Advanced features like shader support, scene graph architecture, and collision detection

Panda3D is used in both commercial games and academic research projects, making it a valuable tool for game developers, researchers, and students.

What This Server Does

This MCP server serves as a bridge between Claude and the official Panda3D documentation. It:

1. Receives documentation queries from Claude through the Model Context Protocol

2. Uses Puppeteer to search the official Panda3D documentation website

3. Parses and extracts relevant information from search results

4. Returns formatted documentation content back to Claude

Under the hood, the server:

• Launches a headless browser using Puppeteer

• Performs searches on the Panda3D documentation site (https://docs.panda3d.org)

• Extracts search results and detailed content

• Formats the information for optimal readability in Claude

• Provides both a summary of search results and in-depth documentation

Why did I create this?

The Panda3D documentation is one of the largest monsters I've ever had the misfortune of coming across so I use Claude frequently to scrape it.

also probably why the higher level Ursina project (built on panda3d) exists in the first place.

Features

• Direct Search API access: Finds relevant Panda3D classes, functions, and concepts

• Rich Results: Returns both search result listings and detailed content

• Smart Prioritization: Identifies the most relevant result for specific queries

• Debug Information: Includes detailed logs for troubleshooting

• MCP Integration: Works seamlessly within Claude conversations

MCP Tools

Prerequisites

• Node.js (v16 or higher)

• npm (v7 or higher)

Installation

Clone and Build

1. Clone this repository:

   git clone https://github.com/th3w1zard1/mcp-panda3d.git cd mcp-panda3d

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

4. Run the server:

   npm start

Configuration with Claude

For Claude Desktop

Add the server configuration to your Claude Desktop config file:

Windows: Edit %APPDATA%\Claude\claude_desktop_config.json

macOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json

Option 1: Using NPX (Recommended)

Option 2: Using Local Installation

Using with SmitheryAI

If you're using SmitheryAI to manage your MCP servers:

Usage

Once configured, you can ask Claude to search the Panda3D documentation:

Additional parameters:

• check_keywords: Search in module names and titles (default: true)

• search_contents: Search in docstrings and code (default: false)

Example with all parameters:

Claude will return a formatted response including:

1. A list of search results with links

2. Detailed documentation for the most relevant result

3. Debug information for troubleshooting

Usage Examples

This document provides examples of how to use the Panda3D Documentation Server with Claude.

Basic Usage

To ask Claude to search for Panda3D documentation, use the following format:

Example Queries

Looking up a Class

This will return documentation about the NodePath class, which is one of the fundamental classes in Panda3D used to represent a node in the scene graph.

Searching for a Method

This will return documentation about the setPos method, which is used to position objects in 3D space.

Finding Information about a Concept

This will return information about Panda3D's collision detection system.

Searching in Docstrings and Code

To search within function docstrings and code (not just titles):

This enables a more comprehensive search that looks within the content of the documentation.

Advanced Usage

Controlling Search Behavior

You can control the search behavior with additional parameters:

• check_keywords: Search in module names and titles (default: true)

• search_contents: Search in docstrings and code (default: false)

Example Conversation Flow

Here's an example of how you might use the Panda3D Documentation Server in a conversation with Claude:

You: I want to create a simple 3D scene in Panda3D. Where should I start? Claude: To create a simple 3D scene in Panda3D, you'd want to start with the ShowBase class, which initializes the 3D rendering pipeline. Let me get the documentation for you. Claude: @mcp-panda3d get_docs query="ShowBase"

Claude searches and displays the ShowBase documentation

You: How do I add a 3D model to my scene? Claude: You'd use the loader.loadModel method along with a NodePath. Let me get that documentation. Claude: @mcp-panda3d get_docs query="loadModel"

Claude searches and display the loadModel documentation

You: How do I make my model move around? Claude: @mcp-panda3d get_docs query="setPos setHpr interval"

Claude searches and display documentation about positioning, rotation, and animation intervals

Tips for Effective Searches

1. Be specific: Use class names, method names, or specific concepts when possible

2. Use technical terms: Panda3D-specific terminology will yield better results

3. Combine related terms: You can combine multiple related terms in a single query

4. Enable content search: Use search_contents=true for more comprehensive results

5. Follow up: If the initial results don't contain what you need, try reformulating your query

Exploring Common Panda3D Topics

Core Concepts

3D Models and Animation

Physics and Collision

User Input

Rendering and Effects

Development

Build

Watch Mode (for development)

Debug with MCP Inspector

The MCP Inspector provides a web interface for debugging:

Access the inspector in your browser at the URL provided in the console.

Troubleshooting

Common Issues

• Search returns no results: Check your query format and try more general terms

• Browser initialization errors: Make sure your system has a compatible browser for Puppeteer

License

MIT. Do what you want with it, just don't claim it as your own work.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.