Inversiland MCP Server

Model Context Protocol (MCP) server for exploring and understanding the Inversiland dependency injection framework.

Features

This MCP server provides tools for AI assistants to:

• Explore Structure: Navigate the inversiland-source codebase directory tree
• Read Files: Access source code files for analysis
• Search Files: Find files by name pattern
• Get Packages: List all packages in the monorepo with metadata
• Read Core Files: Quickly access key implementation files by category

Auto-Clone Feature

The server automatically clones the Inversiland repository on first run if it doesn't exist locally. No manual setup required!

Installation

Global Installation (Recommended)

npm install -g @abdokouta/inversiland-mcp

Local Installation

npm install @abdokouta/inversiland-mcp

Usage

With Kiro IDE

Add to your .kiro/settings/mcp.json:

{
  "mcpServers": {
    "inversiland": {
      "command": "npx",
      "args": ["-y", "@abdokouta/inversiland-mcp@latest"],
      "disabled": false,
      "autoApprove": [
        "explore_structure",
        "read_file",
        "search_files",
        "get_packages",
        "read_core_files"
      ]
    }
  }
}

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "inversiland": {
      "command": "npx",
      "args": ["-y", "@abdokouta/inversiland-mcp@latest"]
    }
  }
}

Available Tools

explore_structure

Explore the directory structure of inversiland-source.

Parameters:

• maxDepth (optional): Maximum depth to explore (default: 3)

Example:

{
  "maxDepth": 4
}

read_file

Read the content of a specific file.

Parameters:

• path (required): Relative path from inversiland-source root

Example:

{
  "path": "packages/core/src/container.ts"
}

search_files

Search for files by name pattern.

Parameters:

• pattern (required): File name pattern to search for

Example:

{
  "pattern": "container"
}

get_packages

Get information about all packages in the monorepo.

Parameters: None

read_core_files

Read multiple core implementation files at once.

Parameters:

• category (required): One of "container", "module", "decorator", "metadata", or "all"

Example:

{
  "category": "container"
}

Environment Variables

• INVERSILAND_SOURCE_PATH: Custom path for the Inversiland repository (optional, defaults to auto-clone location)

Use Cases

Debugging Container Issues

When you encounter container resolution errors like "No matching bindings found", use this MCP to:

1. Explore the container implementation: read_core_files with category "container"
2. Understand how modules work: read_core_files with category "module"
3. Check decorator implementations: read_core_files with category "decorator"

Understanding Module Imports

To understand how module imports and exports work:

1. Search for module-related files: search_files with pattern "module"
2. Read the module decorator: read_file with path to module decorator
3. Explore the module resolution logic in the container

Analyzing Provider Resolution

To debug provider resolution issues:

1. Read container implementation files
2. Search for "provider" or "binding" related files
3. Understand the metadata system that tracks dependencies

Development

# Clone this repository
git clone https://github.com/abdokouta/inversiland-mcp.git
cd inversiland-mcp

# Install dependencies
npm install

# Build
npm run build

# Test locally
node dist/index.js

Repository

The server clones from: https://github.com/ChechaValerii/inversiland

License

MIT

Author

Abdo Kouta