{"_id":"@abdokouta/inversiland-mcp","_rev":"2-8c242cb4ff6ab6ee324793004c2690a6","name":"@abdokouta/inversiland-mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@abdokouta/inversiland-mcp","version":"0.1.0","keywords":["mcp","inversiland","dependency-injection","di","ioc","model-context-protocol"],"author":{"name":"Abdo Kouta"},"license":"MIT","_id":"@abdokouta/inversiland-mcp@0.1.0","maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"homepage":"https://github.com/abdokouta/inversiland-mcp#readme","bugs":{"url":"https://github.com/abdokouta/inversiland-mcp/issues"},"bin":{"inversiland-mcp":"dist/index.js"},"dist":{"shasum":"4d0202123e9b8c3e9e5963d5f0904442984d627b","tarball":"https://registry.npmjs.org/@abdokouta/inversiland-mcp/-/inversiland-mcp-0.1.0.tgz","fileCount":7,"integrity":"sha512-amtvoAsEgtm1LvBhn4lMaRx7MAoq0tGQ8I+Ewq7gd5lIt/WvWihRJ0ECT06ohMcYEXEowp2GtvzX6nedU8h9Lg==","signatures":[{"sig":"MEUCIEW9fFeUIYO+30ThFQaobeL0M2RALtJZ6q6zXFjP5bvEAiEA1CmgSeotT9FsCibJZ7hlHPdS3xFp0ufVe4gJ7+VDmzs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30749},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"9bfeefabb8afebabe416c996c78b20d652d9c239","scripts":{"dev":"tsc --watch","build":"tsc","prepare":"npm run build","prepublishOnly":"npm run build"},"_npmUser":{"name":"abdokouta","email":"akouta66@gmail.com"},"repository":{"url":"git+https://github.com/abdokouta/inversiland-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Inversiland dependency injection framework - automatically clones and explores the source code","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/inversiland-mcp_0.1.0_1774920937454_0.9903746363519119","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@abdokouta/inversiland-mcp","version":"0.1.1","description":"MCP server for Inversiland dependency injection framework - automatically clones and explores the source code","type":"module","bin":{"inversiland-mcp":"dist/index.js"},"scripts":{"build":"tsc","postbuild":"chmod +x dist/index.js","dev":"tsc --watch","prepare":"npm run build","prepublishOnly":"npm run build"},"keywords":["mcp","inversiland","dependency-injection","di","ioc","model-context-protocol"],"author":{"name":"Abdo Kouta"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/abdokouta/inversiland-mcp.git"},"bugs":{"url":"https://github.com/abdokouta/inversiland-mcp/issues"},"homepage":"https://github.com/abdokouta/inversiland-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"_id":"@abdokouta/inversiland-mcp@0.1.1","gitHead":"6d2d6e472e6b4afafc9b6cd14d10edd34eb78c3c","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-c/ea/I2DP7EMGUdCGQxGWDFjHtiHquKxndRc1BDWdhMKF4BM5E0BhsquIkEbu/E7nXDSCiE9XSMfN3DJ7izDYA==","shasum":"d156540683a92f19b91fd6676c8ea2b5709f6fc6","tarball":"https://registry.npmjs.org/@abdokouta/inversiland-mcp/-/inversiland-mcp-0.1.1.tgz","fileCount":7,"unpackedSize":30792,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC57YlOhLaYWuVZcDO1OrHkDnJ5str0vPv0hWZ1BpEgYQIga/m6NjRbTdXIDkxdnRqpb2Fmav0pX58i06a7nbzRxPo="}]},"_npmUser":{"name":"abdokouta","email":"akouta66@gmail.com"},"directories":{},"maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/inversiland-mcp_0.1.1_1774921393023_0.9768534511655869"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T01:35:37.383Z","modified":"2026-03-31T01:43:13.270Z","0.1.0":"2026-03-31T01:35:37.581Z","0.1.1":"2026-03-31T01:43:13.164Z"},"bugs":{"url":"https://github.com/abdokouta/inversiland-mcp/issues"},"author":{"name":"Abdo Kouta"},"license":"MIT","homepage":"https://github.com/abdokouta/inversiland-mcp#readme","keywords":["mcp","inversiland","dependency-injection","di","ioc","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/abdokouta/inversiland-mcp.git"},"description":"MCP server for Inversiland dependency injection framework - automatically clones and explores the source code","maintainers":[{"name":"abdokouta","email":"akouta66@gmail.com"}],"readme":"# Inversiland MCP Server\n\nModel Context Protocol (MCP) server for exploring and understanding the [Inversiland](https://github.com/ChechaValerii/inversiland) dependency injection framework.\n\n## Features\n\nThis MCP server provides tools for AI assistants to:\n\n- **Explore Structure**: Navigate the inversiland-source codebase directory tree\n- **Read Files**: Access source code files for analysis\n- **Search Files**: Find files by name pattern\n- **Get Packages**: List all packages in the monorepo with metadata\n- **Read Core Files**: Quickly access key implementation files by category\n\n## Auto-Clone Feature\n\nThe server automatically clones the Inversiland repository on first run if it doesn't exist locally. No manual setup required!\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g @abdokouta/inversiland-mcp\n```\n\n### Local Installation\n\n```bash\nnpm install @abdokouta/inversiland-mcp\n```\n\n## Usage\n\n### With Kiro IDE\n\nAdd to your `.kiro/settings/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"inversiland\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abdokouta/inversiland-mcp@latest\"],\n      \"disabled\": false,\n      \"autoApprove\": [\n        \"explore_structure\",\n        \"read_file\",\n        \"search_files\",\n        \"get_packages\",\n        \"read_core_files\"\n      ]\n    }\n  }\n}\n```\n\n### With Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"inversiland\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abdokouta/inversiland-mcp@latest\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n### explore_structure\n\nExplore the directory structure of inversiland-source.\n\n**Parameters:**\n- `maxDepth` (optional): Maximum depth to explore (default: 3)\n\n**Example:**\n```typescript\n{\n  \"maxDepth\": 4\n}\n```\n\n### read_file\n\nRead the content of a specific file.\n\n**Parameters:**\n- `path` (required): Relative path from inversiland-source root\n\n**Example:**\n```typescript\n{\n  \"path\": \"packages/core/src/container.ts\"\n}\n```\n\n### search_files\n\nSearch for files by name pattern.\n\n**Parameters:**\n- `pattern` (required): File name pattern to search for\n\n**Example:**\n```typescript\n{\n  \"pattern\": \"container\"\n}\n```\n\n### get_packages\n\nGet information about all packages in the monorepo.\n\n**Parameters:** None\n\n### read_core_files\n\nRead multiple core implementation files at once.\n\n**Parameters:**\n- `category` (required): One of \"container\", \"module\", \"decorator\", \"metadata\", or \"all\"\n\n**Example:**\n```typescript\n{\n  \"category\": \"container\"\n}\n```\n\n## Environment Variables\n\n- `INVERSILAND_SOURCE_PATH`: Custom path for the Inversiland repository (optional, defaults to auto-clone location)\n\n## Use Cases\n\n### Debugging Container Issues\n\nWhen you encounter container resolution errors like \"No matching bindings found\", use this MCP to:\n\n1. Explore the container implementation: `read_core_files` with category \"container\"\n2. Understand how modules work: `read_core_files` with category \"module\"\n3. Check decorator implementations: `read_core_files` with category \"decorator\"\n\n### Understanding Module Imports\n\nTo understand how module imports and exports work:\n\n1. Search for module-related files: `search_files` with pattern \"module\"\n2. Read the module decorator: `read_file` with path to module decorator\n3. Explore the module resolution logic in the container\n\n### Analyzing Provider Resolution\n\nTo debug provider resolution issues:\n\n1. Read container implementation files\n2. Search for \"provider\" or \"binding\" related files\n3. Understand the metadata system that tracks dependencies\n\n## Development\n\n```bash\n# Clone this repository\ngit clone https://github.com/abdokouta/inversiland-mcp.git\ncd inversiland-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nnode dist/index.js\n```\n\n## Repository\n\nThe server clones from: https://github.com/ChechaValerii/inversiland\n\n## License\n\nMIT\n\n## Author\n\nAbdo Kouta\n","readmeFilename":"README.md"}