local_dev_from_filesystem

Create a local development environment from a filesystem path to run tests and view coverage in sandboxed Python, Node, or Bun projects.

Instructions

Create a new local development environment from a filesystem path

Input Schema

TableJSON Schema

Name	Required	Description	Default
`path`	Yes	Local filesystem path

Implementation Reference

src/mcp_local_dev/server.py:103-120 (handler)

Handler for the local_dev_from_filesystem tool: calls create_environment_from_path and formats response with environment details.

elif name == "local_dev_from_filesystem":
    env = await create_environment_from_path(arguments["path"])
    return [
        types.TextContent(
            type="text",
            text=json.dumps(
                {
                    "success": True,
                    "data": {
                        "id": env.id,
                        "working_dir": str(env.sandbox.work_dir),
                        "created_at": env.created_at.isoformat(),
                        "runtime": env.runtime_config.name.value,
                    },
                }
            ),
        )
    ]

src/mcp_local_dev/server.py:35-45 (schema)

Input schema and metadata for the local_dev_from_filesystem tool, registered in the tools list.

types.Tool(
    name="local_dev_from_filesystem",
    description="Create a new local development environment from a filesystem path",
    inputSchema={
        "type": "object",
        "properties": {
            "path": {"type": "string", "description": "Local filesystem path"}
        },
        "required": ["path"],
    },
),

src/mcp_local_dev/environments/environment.py:41-62 (helper)

Main helper function implementing the environment creation from a local path: sandbox creation, file copy, runtime detection and installation.

async def create_environment_from_path(path: Path) -> Environment:
    """Create new environment from filesystem path."""
    env_id = b58_fuuid()
    sandbox = await create_sandbox(f"mcp-{env_id}-")

    shutil.copytree(path, sandbox.work_dir, dirs_exist_ok=True)
    os.chmod(sandbox.work_dir, 0o700)
    os.chmod(sandbox.bin_dir, 0o700)

    runtime_config = detect_runtime(sandbox)
    await install_runtime(sandbox, runtime_config)

    env = Environment(
        id=env_id,
        runtime_config=runtime_config,
        sandbox=sandbox,
        created_at=datetime.now(timezone.utc),
    )

    _ENVIRONMENTS[env_id] = env
    return env

mcp-local-dev