{"_id":"@codewithdan/ai-repo-adventures-mcp","_rev":"7-44605a821eeb79000836d06daf422e75","name":"@codewithdan/ai-repo-adventures-mcp","dist-tags":{"latest":"1.10.3"},"versions":{"1.9.0":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.9.0","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.9.0","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"./dist/server.js"},"dist":{"shasum":"cf282ebcdcd399755c93b1b0110cce71fa2fc117","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.9.0.tgz","fileCount":32,"integrity":"sha512-ZtVCBFdp0Y0DUSGheQBlVPS5A21r+AJi0BE8SP0duc4QdTBLHyn8S2SvKuk0QR4/xx8I85iaReKpySDGeJtQWg==","signatures":[{"sig":"MEYCIQCLgkI2Q/yRHBRPZJXo70kFTKxqnpyQ5sOaK+XO8cHrdwIhALWMhrrI+mK0O3hpvlfKyeCaFiT/6cGgir5IFpjB42tP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100633},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"df1300eee5570014b2e03cd15e470216b3668fbf","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.0.4","@codewithdan/ai-repo-adventures-core":"^1.8.11"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.9.0_1759559912480_0.1434443519723858","host":"s3://npm-registry-packages-npm-production"}},"1.9.1":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.9.1","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.9.1","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"./dist/server.js"},"dist":{"shasum":"c3e98f2c80ccbec064be6a084e9b5f08b2233cdd","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.9.1.tgz","fileCount":32,"integrity":"sha512-HV1HBof1TCUQCZAOCJpG116vX0sIpwwB/XrzYykFRTV2+ApL1lpyv3FiK8B2Lib4pXNO0nukgWsi55kmb1F9iA==","signatures":[{"sig":"MEUCIQDPbd4WTEvMI4iOrrfWEvP1l3HpqoSKeyE328ffMrEogAIgKJmH1B18ZReTh4KV7tQP2idh2otkHsXo/5+a7JhYEuw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100633},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"05d7ef21eec719719287fcb7371ad6d17ba219c6","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.0.4","@codewithdan/ai-repo-adventures-core":"^1.8.12"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.9.1_1759561190349_0.6678386977828876","host":"s3://npm-registry-packages-npm-production"}},"1.9.2":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.9.2","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.9.2","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"./dist/server.js"},"dist":{"shasum":"bf8f64f98d97aab114c8b07c6b8f1f6074662ab6","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.9.2.tgz","fileCount":32,"integrity":"sha512-CyZgkdffT8K4waN32lVOT2kDFlKA06gYQPKp8dhQWfhYWh8n0OQDUsU4dBlceQhY4oKgk2Jl4ZofDvvSlu/olw==","signatures":[{"sig":"MEYCIQC2nUY8RNci7rCl9JIMZDdPEsH1btCS0cmyAU98Y1aaPgIhAL55CriCyy97ywC3G1Lqs8lsZNtwTDiClR1IXWbe9g4a","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100634},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"480448e45d9e23f1944f32b169c283464808c317","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/8.2.3/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.22.4","@modelcontextprotocol/sdk":"^1.0.4","@codewithdan/ai-repo-adventures-core":"^1.8.13"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.9.2_1759561969822_0.7180881548584752","host":"s3://npm-registry-packages-npm-production"}},"1.10.0":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.10.0","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":"Dan Wahlin","license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.10.0","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"./dist/server.js"},"dist":{"shasum":"2a6fd7cfe325253e18f9064871387b1e32ece72c","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.10.0.tgz","fileCount":32,"integrity":"sha512-I9Z8izKDD079HcC7qZjmnlIsfBWareDoYetJdDtXish1vF0NSXglbj97e9V8zfzJdH3ldzBVgrph+d0Xo8tmtg==","signatures":[{"sig":"MEUCIQDnKaXI/y2ehpdbxJLz16F1Wcr/tC0Ihshhxf7dUcvoQgIgR3GY9urBGrk/5nPrIUNUBcF1zLXk3hw3fep4LtjgHtM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103976},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7d56881441b2734c4feadcc249507d4ecb6da827","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/8.2.4/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.19.1","@codewithdan/ai-repo-adventures-core":"^1.10.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.10.0_1759563213674_0.24361267418021093","host":"s3://npm-registry-packages-npm-production"}},"1.10.1":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.10.1","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":{"name":"Dan Wahlin"},"license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.10.1","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"dist/server.js"},"dist":{"shasum":"51d3743355a93334d0c9aeacefc8e0768da0bf0f","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.10.1.tgz","fileCount":32,"integrity":"sha512-eh0lVhe/7c+5kpVgR0EZw/bbkuyc1PXL+8dJ1Iy4OTe8txqGmkhNNXDeg2+JYZd4LJ7z3AumODs1frMEXwV6Wg==","signatures":[{"sig":"MEUCICa71UFnBJToHfJ372BGitC2qpkVWLXm+YTLBat80JYcAiEA9wsbjV8FTXwse0XuN1lkaLQZ+WfE+Ge93aPziGKG57Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103976},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"b596d856c3605e68979316769f727333fb33ebcb","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"git+https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.19.1","@codewithdan/ai-repo-adventures-core":"^1.10.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.10.1_1759563679514_0.050414078488752345","host":"s3://npm-registry-packages-npm-production"}},"1.10.2":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.10.2","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":{"name":"Dan Wahlin"},"license":"MIT","_id":"@codewithdan/ai-repo-adventures-mcp@1.10.2","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"bin":{"repo-adventure-mcp":"dist/server.js"},"dist":{"shasum":"8f8734ebbb9d1281f400679dad0d8f54386aebb5","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.10.2.tgz","fileCount":32,"integrity":"sha512-s88qhb5LSMoOwFfUfDLrcPb5usfJ/JcwaJAFv2SYe/MnSZt3YP4UstJ1yRzbDloPxtdd9/yEp5sobthbfwFnng==","signatures":[{"sig":"MEUCIGRleEKP9EoS897PEn/u3XxvtKgZLVcnZdX1pAu2U5B1AiEA3DcCMGzM3kzlmNaFWkdR1aj/+fN6edgS/BrXPBNuORA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103976},"main":"./dist/server.js","type":"module","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"gitHead":"46650e5bf71b6c1ac9db8ae5d76f49d9b36c49fe","scripts":{"build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"repository":{"url":"git+https://github.com/danwahlin/ai-repo-adventures.git","type":"git","directory":"packages/mcp"},"_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","description":"MCP server for AI-powered code repository exploration through interactive storytelling","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.19.1","@codewithdan/ai-repo-adventures-core":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^24.6.2"},"_npmOperationalInternal":{"tmp":"tmp/ai-repo-adventures-mcp_1.10.2_1759601275437_0.42900700195417696","host":"s3://npm-registry-packages-npm-production"}},"1.10.3":{"name":"@codewithdan/ai-repo-adventures-mcp","version":"1.10.3","description":"MCP server for AI-powered code repository exploration through interactive storytelling","type":"module","bin":{"repo-adventure-mcp":"dist/server.js"},"main":"./dist/server.js","types":"./dist/server.d.ts","scripts":{"build":"tsc","clean":"rm -rf dist","watch":"tsc --watch","start":"node dist/server.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"author":{"name":"Dan Wahlin"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/danwahlin/ai-repo-adventures.git","directory":"packages/mcp"},"homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"dependencies":{"@codewithdan/ai-repo-adventures-core":"^1.10.3","@modelcontextprotocol/sdk":"^1.19.1","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.6.2","typescript":"^5.9.3"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"gitHead":"28b1101719135ea06f732ea50d0b303081f234c3","_id":"@codewithdan/ai-repo-adventures-mcp@1.10.3","_nodeVersion":"20.19.5","_npmVersion":"lerna/9.0.0/node@v20.19.5+x64 (linux)","dist":{"integrity":"sha512-r5vRd6vNVyAl0LjGMtI3oUDDE7PalFVUmS/jWM7kO81kbhbqOzF8+AB/pm3nhJV8Px5CrHUzQMa6GZDrrkduVg==","shasum":"9b8fbd47474f21c9daeb391e718c72f495520842","tarball":"https://registry.npmjs.org/@codewithdan/ai-repo-adventures-mcp/-/ai-repo-adventures-mcp-1.10.3.tgz","fileCount":32,"unpackedSize":103970,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF9MY1f0Ui4ekP7v3lrLdHRHHoUqYGywmXojFjLQl2JFAiEA/O0CcuUW+OE7MaQg/BYg9RCvxBNGF+fFyFOdhgnuHRI="}]},"_npmUser":{"name":"danwahlin","email":"dwahlin@hotmail.com"},"directories":{},"maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ai-repo-adventures-mcp_1.10.3_1759609515118_0.7218992067041294"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-04T06:38:32.363Z","modified":"2025-10-04T20:25:15.556Z","1.9.0":"2025-10-04T06:38:32.663Z","1.9.1":"2025-10-04T06:59:50.538Z","1.9.2":"2025-10-04T07:12:50.067Z","1.10.0":"2025-10-04T07:33:33.915Z","1.10.1":"2025-10-04T07:41:19.755Z","1.10.2":"2025-10-04T18:07:55.626Z","1.10.3":"2025-10-04T20:25:15.352Z"},"bugs":{"url":"https://github.com/danwahlin/ai-repo-adventures/issues"},"author":{"name":"Dan Wahlin"},"license":"MIT","homepage":"https://github.com/danwahlin/ai-repo-adventures#readme","keywords":["mcp","model-context-protocol","claude","ai","llm","code-exploration","storytelling","developer-tools","code-analysis"],"repository":{"type":"git","url":"git+https://github.com/danwahlin/ai-repo-adventures.git","directory":"packages/mcp"},"description":"MCP server for AI-powered code repository exploration through interactive storytelling","maintainers":[{"name":"danwahlin","email":"dwahlin@hotmail.com"}],"readme":"# @codewithdan/ai-repo-adventures-mcp\n\nMCP (Model Context Protocol) server for AI-powered code repository exploration through interactive storytelling. Turn your codebase into an engaging adventure!\n\n## Features\n\n- 🎮 **Story-based Code Exploration**: Interactive \"choose your own adventure\" experience\n- 🤖 **AI-Powered Narratives**: Dynamic story generation using LLMs\n- 🌟 **Multiple Themes**: Space, Mythical, Ancient, and Developer themes\n- 📚 **Educational Analogies**: Complex concepts explained through storytelling\n- 🔍 **Smart Code Analysis**: Automatic detection of technologies and patterns\n- 📊 **Progress Tracking**: Track exploration completion\n\n## Installation\n\n### For Claude Desktop\n\n1. Install the package globally:\n\n```bash\nnpm install -g @codewithdan/ai-repo-adventures-mcp\n```\n\n2. Add to Claude Desktop configuration:\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"repo-adventures\": {\n      \"command\": \"npx\",\n      \"args\": [\"@codewithdan/ai-repo-adventures-mcp\"],\n      \"cwd\": \"/path/to/project/you/want/to/explore\"\n    }\n  }\n}\n```\n\n### For Development\n\n```bash\nnpm install @codewithdan/ai-repo-adventures-mcp\n```\n\n## Available MCP Tools\n\n### `start_adventure`\nAnalyzes your repository and presents theme options.\n\n**Parameters:**\n- `projectPath` (optional): Path to project directory\n\n### `choose_theme`\nGenerates a themed narrative adventure based on your selection.\n\n**Parameters:**\n- `theme`: \"space\", \"mythical\", \"ancient\", or \"developer\"\n\n### `explore_quest`\nExplores specific parts of your codebase through narrative.\n\n**Parameters:**\n- `choice`: Quest number or title\n\n### `view_progress`\nShows your exploration progress and remaining quests.\n\n## Configuration\n\n### LLM Setup (Optional)\n\nCreate a `.env` file in your project:\n\n```bash\n# OpenAI\nREPO_ADV_LLM_API_KEY=your_openai_key_here\nREPO_ADV_LLM_BASE_URL=https://api.openai.com/v1\nREPO_ADV_LLM_MODEL=gpt-4o-mini\n\n# GitHub Models (Free tier available - but very limited and will only work with very small scenarios)\nGITHUB_TOKEN=your_github_token_here\nREPO_ADV_LLM_BASE_URL=https://models.inference.ai.azure.com\nREPO_ADV_LLM_MODEL=gpt-4o-mini\n\n# Azure OpenAI\nREPO_ADV_LLM_API_KEY=your_azure_key_here\nREPO_ADV_LLM_BASE_URL=https://your-resource.openai.azure.com/openai/deployments/your-deployment\nREPO_ADV_LLM_MODEL=gpt-4o\nREPO_ADV_LLM_API_VERSION=2025-01-01-preview\n\n# Local Ollama\nREPO_ADV_LLM_BASE_URL=http://localhost:11434/v1\nREPO_ADV_LLM_API_KEY=ollama\nREPO_ADV_LLM_MODEL=gemma3:27b\n```\n\n### Adventure Configuration\n\nCreate an `adventure.config.json` in your project root:\n\n```json\n{\n  \"adventure\": {\n    \"name\": \"Your Project Name\",\n    \"description\": \"Brief description of what your project does\",\n    \"url\": \"https://github.com/yourusername/yourrepo\",\n    \"quests\": [\n      {\n        \"title\": \"Core Features\",\n        \"description\": \"Explore the main functionality\",\n        \"files\": [\n          {\n            \"path\": \"src/main.ts\",\n            \"description\": \"Main entry point\",\n            \"highlights\": [\n              {\n                \"name\": \"initializeApp\",\n                \"description\": \"Application initialization\"\n              }\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n## Example Usage Flow\n\n```\n1. start_adventure() \n   → Analyzes your project\n   → Returns: \"Choose Your Theme: 1. 🚀 Space 2. 🏰 Mythical 3. 🏛️ Ancient\"\n\n2. choose_theme(\"space\")\n   → Generates personalized story\n   → Returns: Space-themed narrative with quest options\n\n3. explore_quest(\"1\")\n   → Explores specific code area\n   → Returns: Detailed narrative with code insights\n\n4. view_progress()\n   → Shows completion status\n   → Returns: \"33% complete, 2 quests remaining\"\n```\n\n## Supported Technologies\n\nAutomatically detects and creates characters for:\n- **Languages**: TypeScript, JavaScript, Python, Java, Go, Rust, C#\n- **Frameworks**: React, Vue, Angular, Node.js, Express\n- **Databases**: MongoDB, PostgreSQL, MySQL\n- **Tools**: Docker, Kubernetes, Jest, Cypress\n- **APIs**: REST, GraphQL\n\n## Requirements\n\n- Node.js 18.0.0 or higher\n- Claude Desktop (or compatible MCP client)\n- Optional: LLM API key for dynamic content\n\n## License\n\nMIT\n\n## Author\n\nDan Wahlin\n\n## Links\n\n- [GitHub Repository](https://github.com/danwahlin/ai-repo-adventures)\n- [Report Issues](https://github.com/danwahlin/ai-repo-adventures/issues)\n- [NPM Package](https://www.npmjs.com/package/@codewithdan/ai-repo-adventures-mcp)","readmeFilename":"README.md"}