Commit Graph

3 Commits

Author SHA1 Message Date
98b7d4dde8 Add AudioEngineV2 documentation comparison examples
Added comprehensive analysis comparing MCP-enabled vs non-MCP documentation generation for Babylon.js AudioEngineV2.

Contents:
- with_mcp.md: Response generated using babylon-mcp server (3s, 31,669 tokens)
- without_mcp.md: Response generated without MCP (15-20s, 20,906 tokens)
- COMPARISON.md: Detailed analysis of differences and value proposition

Key findings:
- MCP response 5-7x faster generation time
- MCP response 67% more content despite similar token usage
- MCP covers 12 major features vs 6 without MCP
- MCP provides canonical documentation from official sources
- Demonstrates clear value: faster, more comprehensive, authoritative

Analysis shows:
✓ Complete feature coverage (buses, analyzers, buffers, microphone)
✓ Superior migration guidance with V1→V2 comparison table
✓ Better structure for general audience vs VR-focused
✓ Advanced topics included (multi-format, performance metrics)
✓ More code examples (20+ vs 8)

Proves core MCP thesis: reduces token usage while improving quality through direct documentation access.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 08:11:42 -06:00
d747c2ce7c Fix pathToDocId to match actual database ID format
Root cause analysis revealed the previous fix used wrong casing and prefix.

Investigation findings:
- Queried database and found actual IDs use lowercase "documentation_" prefix
- Example: "documentation_features_featuresDeepDive_audio_v2_playingSoundsMusic"
- Previous fix incorrectly used "Documentation_content_" (wrong case + extra "content")

How indexing works:
- Source name: "documentation" (lowercase)
- Source path: ends at .../Documentation/content
- Indexer strips path up to and including /content/
- Prepends source name with underscore: "documentation_"

Correct implementation:
- Strip /content/ from input path (handles both full and relative paths)
- Replace slashes with underscores
- Prepend "documentation_" (lowercase, no "content")

Verified with test:
- Input: "features/featuresDeepDive/audio/v2/playingSoundsMusic"
- Output: "documentation_features_featuresDeepDive_audio_v2_playingSoundsMusic"
- Successfully retrieves document from database

All 152 tests passing.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 07:57:43 -06:00
210ceb7d24 Update README with correct HTTP transport configuration
Updated integration instructions to reflect HTTP transport architecture:
- Clarified that server must be running before connecting clients
- Changed from command-based to URL-based configuration
- Added Claude Code CLI configuration section (~/.claude/config.json)
- Added Linux config file location
- Updated troubleshooting to emphasize server must be running
- Added health check verification step

Configuration now uses:
- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
- Claude Code CLI: ~/.claude/config.json
- URL format: http://localhost:4000/mcp

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 07:36:10 -06:00